logo

Troff - Help

What is Troff

Troff is a media player that let you loop a part of a song, slow it down and create markers on the song timeline.

It is designed for practicing with music, it is perfect for dancers working on a choreography or for musicians learning to play a song.

About this guide

This guide often uses the word "song" instead of "song or movie".

Keyboard shortcuts will be written inside of "()".

Troff is laid out in different sections or areas. They will be referred to as areas in this guide.

Quick Help for Troff - training with music

How to add and play music or movies

When you start Troff, you must add songs from your computer. Do this by clicking the -button (in the attached state) or the "Add files" button (in the floating state) in the Songs area, select one or more songs or movies and click "Open". Then the songs and movies will be saved in Troff and displayed in the songs area.

Note: The files you add will be copied into your web browsers memory. This means that

  1. No data will be sent to the server (unless you share the song); your files will not leave your computer
  2. If you remove or change the original files, your songs in Troff will still be intact (as long as the file-name is the same, you can import the file again to make the changes apply)
  3. Your web-browser might decide to clear it's memory, for what ever reason, and then your songs and markers might disappear. So it's always good to keep the original files.

Remove music or movies

In order to remove songs or movies, open the songlist in floating state. Select the files you want to remove, click the drop-down and select "Remove songs from Troff". After you confirm your selection, the songs will be removed.

Play music or movies

When you have songs in the songs area, click a song and it will be selected. This is indicated by it becoming purple. When the song is loaded, the text "Wait for song to load" written in the top section, will be replaced by the song name, artist and album.

Note: If the text "Wait for song to load" does not disappear, then Troff might not be able to play that particular song. Try to convert the song to mp3 (or movies to mp4) and try again.

To play the song, press the round play-button in the top area or (Space), the song will then wait 3 seconds before start. If you don't want to wait 3 seconds, either press the Enter-key, or continue to read this guide.

Global settings

Troff have a song-specific settings area (explained below: The settings area) as well as global settings. The global settings is where you configure Troff to look and behave the way you like it. These settings will be applied regardless of what song is selected.

You access the global settings via the -button in the top left corner.

Here you decide the theme of Troff, how the marker-color, songlist, space, enter, select marker and delete marker will behave and what areas of Troff that should be visible.

The settings area

The settings area is where you configure Troff to play the current song the way you like it. Here you decide how fast the song will be played, how many times, which part of the song that will be played and more.

Markers - what are those?

Markers are labels that you can add to the timeline. The timeline in Troff is vertical and stretches the full height of the player. The markers contains text, and can be colorized so that you easy can find specific parts of the song later.

To add a marker, press "Add marker!" or (M), then the "create new marker" dialog appears, here you can write the marker name (will be visible on the timeline).

The marker will be added to the timeline where the cursor was when you pressed the button, but the location of the marker can be adjusted in the "create new marker" dialog.

In the info-area you can add more info to the marker. This will not take up space on the timeline but will be easily accessible at the info part. This dialog also lets you decide the color of the marker.

You can always press the edit button () next to a marker to bring up the same dialog to edit the marker.

Play only part of a song

If you want to play only a part of a song, click the marker where you want to start and the marker will be selected (indicated by the purple color). Then click the "stop" button next to the marker where you want Troff to stop playing, the purple color indicates that the "stop" button is selected. When you press "play" only the selected part of the song will be played, the selected part is shown in purple on the timeline.

This is a great way to focus on tricky parts of the song.

Note: You might have noticed that the purple color of the timeline changed when you select start and stop-markers. The purple part is the "active playing region" and indicates simply where Troff will start and end.

If Troff should start playing at the beginning of the active playing region, when pressing space, enter or the play pause button, can be edited in the Global Settings.
But you can always move the cursor to the beginning by pressing "G", as in "Go to marker".

play full song

If you have a small part selected and want to play the whole song you can either press the name of the first marker, and then the stop-button of the last marker, or you can press "play full song" or (U) to select the first and last marker.

move markers

There are a number of ways in which you can change the time of, or move, a marker.

If you press (Shift + Up/Down), (Alt + Up/Down) or (Shift + Alt + Up/Down) the selected marker will move Up/Down by 1, 0.08 or 8 seconds respectively.

You can also click the edit button of the marker, and change the time there.

If you click "advanced" followed by "move markers" you can move all markers at the same time, or just the markers between the two selected ones (including the selected markers).

Export and import

If you want to share your markers to someone, the members of your show-team or band for instance, use the share-button explained in the "Share the song"-section.

However, there is a manuel way to share everything except the song itself. If you want to share the markers manually, press "advanced" followed by "import / export" and the import export dialog appears.

Note: When you export, not only will your markers, marker-info, marker-color be exported, but the states, settings and song-info as well.
More on that later.

When you are exporting you will get a long text-string. Copy the text and share it with your friends that want to import your settings.

To import settings, click on "advanced" followed by "import / export" and then "import", paste the the text-string in the text-box and click ok.

Note: If you miss a single sign or character when copying or pasting, the import will not work. Then, just try again.

Delete markers

There are a number of ways in which you can delete one or several markers.

You can click the edit button of the marker, and then press remove.

If you click "advanced" followed by "delete markers" you will get an option to delete all markers at the same time, or just the markers between the two selected ones (including the selected markers).

When a marker is deleted, there will be a notification square letting you know that the marker has been deleted, as well as an undo-button in the top right corner.

Stretch markers

If you have markers for a song, and then stretch the length of the song in an external program (for instance; using Audacity going to Effect > Change Tempo) then the markers will no longer match the new length of the song.

Then you can stretch the markers. click "advanced" followed by "stretch markers". stretching the markers to 200% will create twice as much space between the markers as before. Stretching them to 50% will reduce the space to half.

There is no "undo" functionality when stretching markers, therefore it is recommended to export your markers and settings first so that you can undo the stretch if it did not match your desired result.

Zoom on the timeline

In Troff, you can zoom in on the timeline which makes it easier to for example focus on a 3 minute song in an 1 hour movie, or just to focus on a few bars in a song.

You zoom by pressing "Zoom" or (Z), this will zoom the timeline to the active playing region, hence select a marker before and after the area you want to zoom to and press (Z).

To zoom out, either select the first and last marker (by "play full song" or (U) ) or press "zoom out" (shift + Z)

Start before and stop after

One way to work with markers is to set a marker at the start of every bar. Then have good short names for the markers and maybe colorize them in a way so that they are easy to understand. This way, it is easy to find the particular part you want to practice. However, you might not want Troff to start playing from the first beat, but rather 3 seconds or so before, so that you can prepare.

Troff lets you do exactly this with the "start before" functionality. If you toggle "start before" or (B) you will se that the "active playing region" will change. If "start before" is active, Troff will start to play the song a few seconds before the selected marker.

The number of seconds can be changed in the start before-number box, or can be increased or decreased by (shift + B) and (alt + B) respectively.

"stop after" works in the same way but for the stop-selected marker.

Play more than once

You can loop the selected playing region a number of times by pressing the number of times you want it to play.

If you press "∞", Troff will loop the selected part of the song until you pause it.

Pause and wait

As default, Troff waits 3 seconds before starting to play a song. This way you can hit play, and then have time to get in position before the song starts.

You can change the number of seconds Troff pauses before starting to play by changing the number in the "pause before"-number box or by (shift + P) and (alt + P).

You can also quickly toggle if Troff should pause or not by pressing "pause before" (P).

"Wait between" works in the same way as "pause before" but it changes the time Troff will wait between loops. It lets you catch your breath before doing it again!

Volume and speed

Troff let you control the volume and speed of the song with a slider, or by using the "+" and "-" buttons.

If you press "Volume" (V) or "Speed" (S) you will reset the values to 100%.

You can also increase or decrease the volume or speed by (shift/alt + V) or (shift/alt + S) respectively.

The info area

The info area is an area where you can take and read notes regarding the current song or marker and check the tempo of a song. If you play a movie in Troff, this will be displayed in the info area.

Tap tempo

If you repeatedly tap "Tempo" (T) to the tempo of the song, Troff will calculate the tempo and display it. This tempo will be saved for the particular song.

Note: Troff will wait 3 seconds before saving the value, so don't change song during that time!

Song info

In the song info, you can write notes and information regarding the current song. These notes will be saved per song and are easily accessible by selecting the song.

Marker info

The marker info works like the song info, but the text written there will be saved per marker. Hence, when another marker is selected, the text displayed will change.

This is a great way to write things that you want to remember for a specific part of the song.

The countdown area

The countdown area shows two things:
The top-number shows the number of seconds until the song will start. It will count down during the "pause before" and the "wait between".
The bottom-number shows the number of loops that are left. It will count down for each time one loop is finished.

Note: The order of the two numbers match the order that you control these values in the Settings-area.

The songs area

The song area is where you can select which song to play. The selected song is purple. If you can't find the song you want, it might be in another songlist, or it has been removed from the computer.

The song area can either be in the attached state, then it will be next to the states and settings, or it can be in the floating state, then it be in a pop-up square.

You can change between the two states in the settings, or with the maximize () and minimize () buttons.

When the song is in the floating state, more info is available about the song in a sortable table.

The songlists area

You can create songlists to only show a few songs in the songs area. There is also the "Gallery List" and "Directory List" which is automatically created based on the folders you have selected and the folders that they contain.

Open the songlist by clicking in the attached state or by clicking the "songlist"-button in the floating state.

To create a new songlist, click "New songlist", give it a name.

Add songs to songlists

There are two ways to add songs to songlists: In the attached state you can select the songs you want to add by selecting the checkbox next to every song and then click the dropdown and select "Add to ...", then all those songs will be added to that songlist. The same way makes it also possible to remove songs from songlist, just select "Remove from ...." instead.
It is also possible to click and drag songs on to songlists to add them, this is possible booth in attached state and floating state.

The states area

What is states

A "state" is something that saves all the values in the settings-area as well as all markers selected.

To understand when this is useful, imagine the following scenario:

Lets say you usually practice a guitar solo of the song. Then you always set the same markers, always set start before to 10 seconds and pause before set to off.

Lets say you also practise the ending of the song. Then you have a different set of markers and start before is set to 3 seconds, and pause before is set to 3 seconds.

States lets you quickly switch between these.

How to use a state

Select the markers and settings you want to save then click "remember state". Name the state and press "OK".

The state will appear as a button in the states list. When you have another marker selected, you can simply press this state to recall the state.

Remove a state by pressing the "R"-button next to it.

Toggle areas

The areas explained in this guide can be toggled on and off. Press the buttons in the top section of the area you want to toggle.

Note: If an area is visible or not is saved with the song.

Play movies

If you select a movie in the songlist that Troff is able to show, the movie will be shown in the info area.

Fullscreen

You can at any time toggle fullscreen by the (F)-key.

The "Play in Fullscreen"-button does not toggle fullscreen, but toggles whether or not Troff should enter fullscreen on play and exit fullscreen on pause.

Note: If you pause Troff and Troff exits fullscreen (because "play in fullscreen" is active), simply press (F) to enter fullscreen again.

Frame by frame stepping

Troff lets you examine what is happening in the movie in detail by allowing frame by frame stepping:

  • Use (alt + left / right arrow) to step one frame forward or backward.
  • Use (left / right arrow) to step one second forward or backward.
  • Use (shift + left / right arrow) to step 10 seconds forward or backward.

Tell your friends about Troff

I would be very grateful if you could tell all your friends about Troff. The more people using Troff the merrier!

Use the following button to send an email about Troff:

... or share this link via your social networks: troff.app

Thank you!

Like us and more

If you like Troff, please take a moment to like uss on Facebook.

If you have questions, suggestions or feedback, please don't hesitate to send an email to slimsimapps@gmail.com

Keyboard shortcuts

SpacePlay/pause (with countdown, from marker)
ReturnPlay/pause (without countdown, from where the cursor is)
EscStop song
M Set marker
G Go to marker
E Edit the marker info text
I Edit the song info text
1-9Set number of times to loop song
0 Loop ''Infinite'' (∞) many times
P Toggle ''Pause bef start''
B Toggle ''Start Before''
A Toggle ''Stop After''
F Toggle fullscreen
Ctrl + F Find song (use arrow-keys + enter to quickly select song)
U Play the entire (full) song
T Tap repeatedly to calculate the tempo of song
V Set Volume to 100%
S Set Speed to 100%
W Set Wait to 1 second
R Remember current state to recall it later
Z Zoom in to only see the active playing region (the purple part of the timeline), use shift+Z to zoom out to see the whole timeline
Left/Right Arrows Use right and left arrows to step 1 sec forward/backward in song/movie, use shift or alt to move 10 seconds / one frame respectively
Up/Down Arrows Move the selected marker up or down, 1 sec, 1 frame or 10 seconds with alt/shift/(alt+shift) + Upp/down respectively.
N Move to next pair of markers (use shift + N to move to previous)