Recent changes to intro

intro modified by rustahm

rustahm — Sun, 12 Mar 2017 12:09:00 -0000

--- v53
+++ v54
@@ -37,7 +37,7 @@

 #### operations with selected tracks

-The operations can be invoked from the context menu of the pick table.
+The operations can be invoked from the context menu of the pick table (right-click).

 * play
 Replaces the current playlist with selected tracks and plays it. If you want to play just one track, just double-click it in the pick table.
@@ -76,7 +76,7 @@

 #### playlist

-The current item has a play icon on the right. If you want to play an item, just double-click it. You can drag items within the playlist to change their order. The context menu is disabled if there are no tracks in the playlist.
+The current item has a play icon on the right. The item is also shown in the window title bar. If you want to play an item, just double-click it. You can drag items within the playlist to change their order. The context menu is disabled if there are no tracks in the playlist.

 
 [[[img src=playlist_context_menu.png/thumb alt='context menu of playlist']]](intro/attachment/playlist_context_menu.png)
@@ -84,7 +84,7 @@

 #### operations with selected tracks

-The operations can be invoked from the context menu of the playlist.
+The operations can be invoked from the context menu of the playlist (right-click).

 * remove selected
 Removes selected items from the playlist. If one of the items is current, playback will be stopped.
@@ -96,7 +96,7 @@
 Clears the playlist. Playback will be stopped.

 * auto-scroll
-Scrolls the playlist to a new current item automatically if it's not visible in the viewport. Enabled by default. Press again to disable.
+Scrolls the playlist to a new current item automatically if it's not visible in the viewport. Enabled by default. Press to disable.

 * remove duplicates
 Removes all duplicate items from the playlist. Disabled if there are no duplicates.

intro modified by rustahm

rustahm — Sun, 12 Mar 2017 11:54:42 -0000

--- v52
+++ v53
@@ -9,11 +9,11 @@

 # general information

-[The Urman Media Manager](home) is a desktop application that allows you to manage your media collection effectively. This task is completed through utilization of [metadata](metadata) base. You are responsible for completeness and accuracy of metadata associated with media files. The more complete and accurate the metadata, the more manageable the media behind it.
+[The Urman Media Manager](home) is a desktop application that allows you to manage your media collection effectively. This task is completed through utilization of [metadata](metadata) base. You are responsible for completeness and accuracy of metadata in the media and metadata files. The more complete and accurate the metadata, the more manageable the media behind it.

 # media sources

-When you start Urman for the first time you see some buttons one of which is red and empty areas. Click the red button to start the media sources dialog where you can specify what directories with media files Urman is to manage and then start scanning for metadata. When the scanning is done, in the pick table you'll see a list of audio tracks that Urman has detected in the specified directories. Information about the total number, duration, and size of all the tracks will be available in the tooltip of the media sources button that won't be red by now.
+When you start Urman for the first time you see a big disabled area called the pick panel, and some buttons one of which is red. The pick table is empty because there are no tracks yet to show. Click the red button to start the media sources dialog where you can specify what directories with media and metadata files Urman is to manage and then get Urman search for metadata. The count column in the dialog shows the number of relevant files in each directory. It is zero for newly added directories and will be updated after the scan. When the searching is done, in the pick table you'll see a list of audio tracks that Urman has detected in the specified media sources. Information about the total number, duration, and size of all the tracks will be available in the tooltip of the media sources button that won't be red by now.

 # the pick panel

@@ -23,13 +23,13 @@

 #### sorting

-If you want to sort the tracks in the table then left-click the corresponding column caption and choose one of the sorting schemes. Columns with an ascending order have a greenish caption and columns with a descending order have a bluish caption.
+If you want to sort the tracks in the table then left-click the corresponding column caption and choose one of the sorting schemes. Columns with an ascending order have a greenish caption and columns with a descending order have a bluish one.
 You can reorder the tracks by sorting metadata in multiple columns. In this case, position of the columns matters: the leftmost column will have the highest priority in sorting, and the farther other columns to the right the less priority they'll have. You can change position of the columns in the columns settings dialog.

 #### filtering

 If you want to filter out the tracks then use the filter bar at the top of the pick panel. The filter is only applied to the metadata for which a corresponding column in the table is shown, i.e. if you want to see all tracks containing the filtering words in their title then the column "title" must be there in the table. You can add or remove columns in the columns settings dialog.
-Urman treats the search query as a regular expression. Shorty, just enter a word or two and the table will only be repopulated with tracks having your words as part of their metadata. Numbers on the left of the filter bar provide information about the total number, duration, and size of the matched tracks. Visit [this page](http://doc.qt.io/qt-5/qregexp.html#details) for more information about regular expressions.
+Now just enter a word or two in the filter field and the table will only be repopulated with tracks having your words as part of their metadata. Numbers on the left of the filter bar provide information about the total number, duration, and size of the matched tracks.

 #### selecting

intro modified by rustahm

rustahm — Sun, 12 Mar 2017 11:23:48 -0000

intro modified by rustahm

rustahm — Tue, 24 Jan 2017 11:21:09 -0000

--- v50
+++ v51
@@ -100,3 +100,6 @@

 * remove duplicates
 Removes all duplicate items from the playlist. Disabled if there are no duplicates.
+
+# keyboard shortcuts
+Not everything in Urman has [shortcuts](shortcuts) but the plan is to make Urman as keyboard-friendly as possible.

intro modified by rustahm

rustahm — Tue, 24 Jan 2017 11:02:08 -0000

--- v49
+++ v50
@@ -96,7 +96,7 @@
 Clears the playlist. Playback will be stopped.

 * auto-scroll
-Scrolls the playlist to a new current item if it's not visible in the viewport.
+Scrolls the playlist to a new current item automatically if it's not visible in the viewport. Enabled by default. Press again to disable.

 * remove duplicates
 Removes all duplicate items from the playlist. Disabled if there are no duplicates.

intro modified by rustahm

rustahm — Tue, 24 Jan 2017 09:52:10 -0000

--- v48
+++ v49
@@ -52,7 +52,7 @@
 Opens the current track in a metadata editor specified in the file associations settings. Disabled if no editor command has been specified.

 * file associations
-Opens the file associations settings dialog. See below for details.
+Starts the file associations dialog. See below for details.

 * move
 Moves selected tracks to another directory. The tracks will be removed from Urman.

intro modified by rustahm

rustahm — Mon, 23 Jan 2017 17:07:30 -0000

--- v47
+++ v48
@@ -5,7 +5,6 @@
 [[[img src=filtered_sorted_selected_and_played_back.png/thumb alt='main window with some tracks filtered, sorted, selected and played back']]](intro/attachment/filtered_sorted_selected_and_played_back.png)
 [[[img src=pick_table_context_menu.png/thumb alt='context menu of pick table']]](intro/attachment/pick_table_context_menu.png)
 [[[img src=file_associations_settings.png/thumb alt='file associations settings dialog']]](intro/attachment/file_associations_settings.png)
-[[[img src=playlist_context_menu.png/thumb alt='context menu of playlist']]](intro/attachment/playlist_context_menu.png)
 

 # general information
@@ -79,6 +78,10 @@

 The current item has a play icon on the right. If you want to play an item, just double-click it. You can drag items within the playlist to change their order. The context menu is disabled if there are no tracks in the playlist.

+
+[[[img src=playlist_context_menu.png/thumb alt='context menu of playlist']]](intro/attachment/playlist_context_menu.png)
+
+
 #### operations with selected tracks

 The operations can be invoked from the context menu of the playlist.

intro modified by rustahm

rustahm — Mon, 23 Jan 2017 17:06:19 -0000

--- v46
+++ v47
@@ -18,25 +18,25 @@

 # the pick panel

-## columns
+#### columns

 In the columns settings dialog you can select which columns of metadata you want to see in the pick table and in what order. You can start the dialog from the context menu of the table header (right-click), and then drag-and-drop items between and within the lists of shown and hidden columns.

-### sorting
+#### sorting

 If you want to sort the tracks in the table then left-click the corresponding column caption and choose one of the sorting schemes. Columns with an ascending order have a greenish caption and columns with a descending order have a bluish caption.
 You can reorder the tracks by sorting metadata in multiple columns. In this case, position of the columns matters: the leftmost column will have the highest priority in sorting, and the farther other columns to the right the less priority they'll have. You can change position of the columns in the columns settings dialog.

-### filtering
+#### filtering

 If you want to filter out the tracks then use the filter bar at the top of the pick panel. The filter is only applied to the metadata for which a corresponding column in the table is shown, i.e. if you want to see all tracks containing the filtering words in their title then the column "title" must be there in the table. You can add or remove columns in the columns settings dialog.
 Urman treats the search query as a regular expression. Shorty, just enter a word or two and the table will only be repopulated with tracks having your words as part of their metadata. Numbers on the left of the filter bar provide information about the total number, duration, and size of the matched tracks. Visit [this page](http://doc.qt.io/qt-5/qregexp.html#details) for more information about regular expressions.

-### selecting
+#### selecting

 You can select tracks in the pick table one by one by pressing and holding the Ctrl key, or in a range by pressing and holding the Shift key or by dragging the mouse over. If you want to select all the displayed tracks then use the keyboard shortcut Ctrl+A. Every time the selection changes the information about the total number, duration, and size of the selected tracks on the right of the filter bar gets updated.

-### operations with selected tracks
+#### operations with selected tracks

 The operations can be invoked from the context menu of the pick table.

@@ -64,22 +64,22 @@
 * delete
 Deletes selected tracks from the file system and Urman.

-### file associations
+#### file associations

 In the file associations dialog you can set commands for media and metadata editors. A command can be picked from a drop-down menu or entered manually. You can start the dialog from the context menu of the pick table (right-click).

 # the play panel
 There is a button in the main tool bar to hide, unhide and set keyboard focus on the panel. If the panel is shown when you press the button it will get the focus if it doesn't have it or will be hidden if it already has the focus.

-### player
+#### player

 Disabled if there are no tracks in the playlist. The playback control buttons will be available when appropriate.

-### playlist
+#### playlist

 The current item has a play icon on the right. If you want to play an item, just double-click it. You can drag items within the playlist to change their order. The context menu is disabled if there are no tracks in the playlist.

-### operations with selected tracks
+#### operations with selected tracks

 The operations can be invoked from the context menu of the playlist.

intro modified by rustahm

rustahm — Mon, 23 Jan 2017 17:04:33 -0000

--- v45
+++ v46
@@ -18,7 +18,7 @@

 # the pick panel

-### columns
+## columns

 In the columns settings dialog you can select which columns of metadata you want to see in the pick table and in what order. You can start the dialog from the context menu of the table header (right-click), and then drag-and-drop items between and within the lists of shown and hidden columns.

intro modified by rustahm

rustahm — Mon, 23 Jan 2017 17:03:49 -0000

--- v44
+++ v45
@@ -8,11 +8,11 @@
 [[[img src=playlist_context_menu.png/thumb alt='context menu of playlist']]](intro/attachment/playlist_context_menu.png)
 

-#general information
+# general information

 [The Urman Media Manager](home) is a desktop application that allows you to manage your media collection effectively. This task is completed through utilization of [metadata](metadata) base. You are responsible for completeness and accuracy of metadata associated with media files. The more complete and accurate the metadata, the more manageable the media behind it.

-#media sources
+# media sources

 When you start Urman for the first time you see some buttons one of which is red and empty areas. Click the red button to start the media sources dialog where you can specify what directories with media files Urman is to manage and then start scanning for metadata. When the scanning is done, in the pick table you'll see a list of audio tracks that Urman has detected in the specified directories. Information about the total number, duration, and size of all the tracks will be available in the tooltip of the media sources button that won't be red by now.

@@ -27,16 +27,16 @@
 If you want to sort the tracks in the table then left-click the corresponding column caption and choose one of the sorting schemes. Columns with an ascending order have a greenish caption and columns with a descending order have a bluish caption.
 You can reorder the tracks by sorting metadata in multiple columns. In this case, position of the columns matters: the leftmost column will have the highest priority in sorting, and the farther other columns to the right the less priority they'll have. You can change position of the columns in the columns settings dialog.

-###filtering
+### filtering

 If you want to filter out the tracks then use the filter bar at the top of the pick panel. The filter is only applied to the metadata for which a corresponding column in the table is shown, i.e. if you want to see all tracks containing the filtering words in their title then the column "title" must be there in the table. You can add or remove columns in the columns settings dialog.
 Urman treats the search query as a regular expression. Shorty, just enter a word or two and the table will only be repopulated with tracks having your words as part of their metadata. Numbers on the left of the filter bar provide information about the total number, duration, and size of the matched tracks. Visit [this page](http://doc.qt.io/qt-5/qregexp.html#details) for more information about regular expressions.

-###selecting
+### selecting

 You can select tracks in the pick table one by one by pressing and holding the Ctrl key, or in a range by pressing and holding the Shift key or by dragging the mouse over. If you want to select all the displayed tracks then use the keyboard shortcut Ctrl+A. Every time the selection changes the information about the total number, duration, and size of the selected tracks on the right of the filter bar gets updated.

-###operations with selected tracks
+### operations with selected tracks

 The operations can be invoked from the context menu of the pick table.

@@ -64,6 +64,36 @@
 * delete
 Deletes selected tracks from the file system and Urman.

-###file associations
+### file associations

 In the file associations dialog you can set commands for media and metadata editors. A command can be picked from a drop-down menu or entered manually. You can start the dialog from the context menu of the pick table (right-click).
+
+# the play panel
+There is a button in the main tool bar to hide, unhide and set keyboard focus on the panel. If the panel is shown when you press the button it will get the focus if it doesn't have it or will be hidden if it already has the focus.
+
+### player
+
+Disabled if there are no tracks in the playlist. The playback control buttons will be available when appropriate.
+
+### playlist
+
+The current item has a play icon on the right. If you want to play an item, just double-click it. You can drag items within the playlist to change their order. The context menu is disabled if there are no tracks in the playlist.
+
+### operations with selected tracks
+
+The operations can be invoked from the context menu of the playlist.
+
+* remove selected
+Removes selected items from the playlist. If one of the items is current, playback will be stopped.
+
+* the last to play
+Selected item will be the last to play and playback will be stopped thereafter. The item will have a stop icon on the right if it's not current or a skip forward button otherwise. You can unset it by repeating the process.
+
+* clear
+Clears the playlist. Playback will be stopped.
+
+* auto-scroll
+Scrolls the playlist to a new current item if it's not visible in the viewport.
+
+* remove duplicates
+Removes all duplicate items from the playlist. Disabled if there are no duplicates.