tsiry-sandratraina.com
A modern Music Player Daemon based on Rockbox open source high quality audio player
libadwaita
audio
rust
zig
deno
mpris
rockbox
mpd
1\subsection{Shortcuts}
2\label{ref:Shortcutsplugin}
3
4The Shortcuts Plugin allows you to jump to places within the file browser
5without having to navigate there manually. The plugin works with
6\fname{.link} files. A \fname{.link} file is just a text file with every
7line containing the name of the file or the directory you want to quickly
8jump to. All names should be full absolute names, i.e. they should start
9with a \fname{/}. Directory names should also end with a \fname{/}.
10
11\note{This plugin cannot read Microsoft Windows shortcuts (\fname{.lnk}
12files). These are handled by a separate plugin; see
13\reference{ref:Winshortcutsplugin}.}
14
15\subsubsection{How to create \fname{.link} files}
16
17You can use your favourite text editor to create a \fname{.link} file on the
18PC an then copy the file to the \dap{}. Or you can use the context menu on
19either a file or a directory in the file browser tree, and use the ``Add to
20shortcuts'' menu option. This will append a line with the full name of the
21file or the directory to the \fname{shortcuts.link} file in the root
22directory of the \dap{}. (The file will be created if it does not exist
23yet.) You can later rename the automatically created \fname{shortcuts.link}
24file or move it to another directory if you wish. Subsequent calls of the
25context menu will create it again.
26
27
28\subsubsection{How to use \fname{.link} files, i.e. jump to desired places}
29
30To use a \fname{.link} file just ``play'' it from the file browser. This will
31show you a list with the entries in the file. Selecting one of them will
32then exit the plugin and leave you within the directory selected, or with
33the file selected in the file browser. You can then play the file or do
34with it whatever you want. The file will not be ``played'' automatically.
35
36If the \fname{.link} file contains only one entry no list will be shown, you
37will directly jump to that location. The file \fname{shortcuts.link} in the
38root directory is an exception. After ``playing'' it, the list will be shown
39even if the file contains just one entry.
40
41If the list you are seeing is from \fname{shortcuts.link} in the root
42directory, you can delete the selected entry by pressing \ActionStdMenu.
43Deleting entries from other \fname{.link} files is not possible.
44
45
46\subsubsection{Advanced Usage}
47
48Placing the line ``\#Display last path segments=n'' (where n is a number) in
49the beginning of a \fname{.link} file will leave just the last n segments of
50the entries when they are shown. For example, if n is chosen to be 1, then
51the entry \fname{/MyMusic/collection/song.mp3} will be shown as
52\fname{song.mp3}. This allows you to hide common path prefixes.
53
54You can also provide a custom display name for each entry individually. To
55do so, append a tabulator character after the entry's path followed by your
56custom name. That name will then be used for showing the entry. For example:
57\begin{example}
58 /MyMusic/collection/song.mp3<TAB>My favourite song\symbol{33}
59\end{example}