summaryrefslogtreecommitdiffstats
path: root/manual
AgeCommit message (Collapse)AuthorFilesLines
14 daysfiiom3k: Recording keymap adjustmentChristian Soffke1-2/+2
Long button presses to create a new file were in conflict with button presses to play/pause. Pressing SELECT is now used to create a new file (and start recording, if stopped), pressing PLAY/PAUSE will start or pause recording. Change-Id: If2e568b9b05500d73fd54b691262a64d1a0ff487
2023-09-18[Feature] Skip to next file even if loop one is set.William Wilgus1-2/+2
repeat one till manually skipped https://forums.rockbox.org/index.php/topic,54218.0.html Change-Id: If2ea1cd892531c735c30c428dea3678806283a3b
2023-05-26PictureFlow: Remove menu items for "Return" and "Clear Playlist"Christian Soffke1-2/+0
On all players, it should be possible to return from the Main Menu by pressing the Back or Menu key. Unless I'm missing something... "Clear Playlist" has hopefully become superfluous after the "Playing Next" context menu was added, which offers similar functionality. Change-Id: I741544978fb7936b8d5a34dfc656472e20c1737e
2023-05-26PictureFlow: Add ability to go to last albumChristian Soffke1-0/+1
After launch, PictureFlow always goes to the currently playing album, or to a selected album, if applicable. Which is probably a useful default, but not always wanted. You can now get back to the album you were looking at when PictureFlow was last closed, or when the sorting was last changed. Change-Id: Iba3e0d5388f6b49534d09fe0224b0dbfa65d5f1d
2023-05-26PictureFlow: Scroll through albums from track listChristian Soffke1-0/+1
This lets players that can't spare any keys scroll through albums without leaving the track listing first, which was only possible on the M3K before. Enter mode from Main Menu. While active, the gradient highlighting an album's selected track will not appear, and context menu options apply to the whole album instead of to a single track. Exit mode by pressing buttons for Select/Back, or by quitting PictureFlow. NB: Be sure to enable "Database in RAM" for a good experience, as the loading time for each album can become quite annoying otherwise. Change-Id: Id6c9a8cc49e4cfb2aea958610b95a19887f496b6
2023-05-24Sansa Clip keymap: Playlist on short Down press and Hotkey on long Down ↵roman.artiukhin1-2/+2
press in WPS Change-Id: I39a01df90b658d76b9cf2f94d9a81a4f7ff076cf
2023-03-21makefiles: Suppress stray backslash warnings with grep 3.8Aidan MacDonald1-1/+1
GNU grep 3.8 warns about "\#" when compiling. The "#" has to be escaped for Makefiles and shell, but it isn't special to grep so grep thinks it's an invalid escape sequence. Change-Id: Ieb2607d42b7daa1939ca0101b915ec0c7afd4298
2023-02-07SID: Disable SID on 2MB targets, as cRSID needs a lot of RAM.Solomon Peachy1-2/+3
Also add a note that SID might not play in realtime on all targets Change-Id: Ic14b20a7c1427e31e38204ae3ecff6bd235ec1b4
2023-01-22Fix manuals 5b27e2255aAidan MacDonald1-3/+2
Some targets don't have \ButtonVolUp and \ButtonVolDown so reword to avoid using them. Change-Id: I5353d85e579f51e07555e1048b40d90bffa9ae90
2023-01-22Add perceptual volume adjustmentAidan MacDonald1-0/+17
The perceived loudness change of a change in volume depends on the listening volume: at high volumes a 1 dB increment is noticeable, but at low volumes a larger increment is needed to get a comparable change in loudness. Perceptual volume adjustment accounts for this fact, and divides the hardware volume range into a number of steps. Each step changes the dB volume by a variable amount, with most of the steps concentrated at higher volumes. This makes it possible to sweep over the entire hardware volume range quickly, without losing the ability to finely adjust the volume at normal listening levels. Use "Volume Adjustment Mode" in the system settings menu to select perceptual volume mode. The number of steps used is controlled by "Number of Volume Steps". (Number of steps has no effect in direct adjustment mode.) It's still possible to set a specific dB volume level from the sound settings menu when perceptual volume is enabled, and perceptual volume does not affect the volume displayed by themes. Change-Id: I6f91fd3f7c5e2d323a914e47b5653033e92b4b3b
2023-01-14PictureFlow: Add ability to insert into playlistsChristian Soffke1-2/+2
Songs or albums can now be added to new or existing playlists directly from PictureFlow. Change-Id: I6ea27e393fee0d5688385f9e91cf835be1756a7a
2023-01-10PictureFlow: Add 'Track Info' for tracks or whole albumsChristian Soffke1-3/+5
Context menu gains new option to view metadata for individual tracks or albums. Will display an album's length and total file size. Other fields are displayed only if they are identical across all tracks (except for the album year, which is determined by the highest value encountered). Change-Id: Ibc14cfaf2cb3d91b8d1cfbee05c6261db4975355
2023-01-07manual: Update screenshotsChristian Soffke37-0/+0
Change-Id: I264210ee0a759fc3a7e89578f7d9d32d58dfd609
2023-01-07Rename "Playing Next..." menu items & hide Queue/ShuffleChristian Soffke1-36/+31
"Play Next" instead of "Insert Next" "Add" instead of "Insert" "Play Last" instead of "Insert Last" "Add Shuffled" instead of "Insert Shuffled" "Play Last Shuffled" instead of "Insert Last Shuffled" -"Queue" items hidden by default - Shuffled options hidden by default (Both can be enabled in options) Resulting default menu: Playing Next... Play Next Add Play Last Play Change-Id: Ib0c07a8077ab4b10c2dbc7af33516adcd0d4b83a
2023-01-07Rename “Current Playlist” and “Playlist Catalogue” context menusChristian Soffke6-34/+34
Use action-oriented and more descriptive titles "Add to Playlist..." instead of "Playlist Catalogue" - "Add to Existing Playlist" instead of "Add to Playlist" - "Add to New Playlist" (unchanged) - "Playing Next..." instead of "Current Playlist" In WPS context menu: - "Current Playlist" instead of "Playlist" Change-Id: I5cce9e317676537988682f46ac6b920598af3b9e
2023-01-07File Browser: Add “Set As..." context menuChristian Soffke2-17/+22
Moves options for configuring: - Playlist Directory - Recording Directory - Start Directory into a single menu. Necessary prerequisite for giving the "Playlist Catalogue" context menu item a title that's a little more action-oriented ("Add to Playlist…”). Change-Id: I4ee08fc67d5350c38ae1a57cb345c4ed1082d0b5
2023-01-02Increase maximum files in directory limitAidan MacDonald1-8/+11
Increase the default limit to 5000 files for targets with at least 8 MiB of RAM (the vast majority). The upper limit of the setting is now 40,000 or 100,000 if you have at least 8 MiB or 16 MiB of RAM, respectively. Update the manual to mention that this setting can also impact the database browser. "Using the Database" already mentions it, but it's useful to say so in the setting's description. Change-Id: I6f204eec6cf2ccaea2af81d2fa287f92476eed4a
2023-01-02manuals: Update warning on max entries in file browser / playlistAidan MacDonald1-6/+8
These settings have a warning that increasing them will shorten the audio buffer. This is not very useful, because users might not know what "shortening the music buffer" implies. Since the size of the audio buffer is probably irrelevant for flash based storage, display the warning only for HDD-based targets, and explain what the drawbacks may be if the settings are set too high. Change-Id: Ie9eb4907c67e20695bfa083e1c2a29385e66afcf
2022-12-29plugins: SpaceRocks: iPod keymap, use Menu button for MenuChristian Soffke1-4/+4
Missing from faa2cb9 - Thrust is now Right instead of Menu - Teleport is Left instead of Play/Pause - Pause is Play/Pause Change-Id: Idd9758a68250bcfb2adec14589dffbe1a091511c
2022-12-29plugins: Improve usability of iPod keymapsChristian Soffke44-71/+108
- Reduce need to press multiple buttons at the same time to quit a plugin - Have "Menu" be default way to quit plugins or to access plugin menu - Fall back to (Long) "Select" or Long "Menu" in cases where Menu button isn't available (e.g. in ImageViewer and many games) out of scope: boomshine, lua_scripts, Rockpaint, Doom, Duke3D, Pacbox, Quake, Sgt-Puzzles, Wolf3D, XWorld, Minesweeper, Pixel Painter, Spacerocks Change-Id: I6d4dc7174695fe4b8ee9cbaccb21bdbfe6af5c48
2022-12-13Exit Pitchscreen on BUTTON_HOME for Sansa Cliproman.artiukhin1-3/+3
ToggleMode is remapped to BUTTON_SELECT Reset is remapped to Long BUTTON_HOME or Long BUTTON_SELECT (avoids accidental reset by pressing BUTTON_SELECT) Change-Id: I6fc4050c66db2d7db7ec899f9c83b70754fef9df
2022-12-03tagcache: add a setting for customizing the database pathAidan MacDonald1-0/+1
Add a new setting, database path: /path/to/folder to change where the database files are stored, which allows it to be shared by multiple builds when using multiboot. This avoids the need to maintain a separate copy of the database for each build. This setting can only be set from the config file; it has no menu option yet (due to lack of a GUI to pick the directory). Change-Id: Ide7b3ccdd84abb62b52f900421bd3d101773e093
2022-11-23PictureFlow: Add hotkeys for changing sorting on iPods / Update manualChristian Soffke1-10/+13
Adjust current sorting by pressing both the Select button and Menu (or Play) at the same time. Change-Id: I474b79a16e278d34e3983384125015bdfb6f484a
2022-11-12Implement Rewind across tracks functionalityroman.artiukhin2-0/+7
Useful feature for audiobooks. To rewind from the end of the previous track - press rewind at the very beginning of the current track. So if you are in the middle of the track - first rewind till beginning then release and press rewind button again (Playback Settings -> Rewind Across Tracks option should be enabled) Fixes FS#13290 Change-Id: I5d7f06f64ad76d1e8f7827fe594ccca5f621769d
2022-10-25manual: update quickscreen defaultsChristian Soffke1-3/+2
'Show Files' hasn't been a default QuickScreen setting for a while Change-Id: I9ed95897bef5c3b95d38e3ee5a7db3cb723cb17b
2022-10-25Enable access to Shortcuts Menu from QuickScreenChristian Soffke1-0/+3
Offers a quick way of switching to the Shortcuts Menu by pressing the 'context menu' button while QuickScreen is active (e.g. long press Select on iPods and some other players) Change-Id: I38292c7070cf093a81e1db688809b1f0d6a8764a
2022-10-13Revert "RFC: Get rid of mpegplayer plugin"Solomon Peachy2-0/+121
This reverts commit d25d24812e8120c0eb133a412287ac030eb185c9. Change-Id: I1563223e343fb1e2eda72a45823b38350025ff93
2022-10-02RFC: Get rid of mpegplayer pluginSolomon Peachy2-121/+0
It might have made sense once upon a time, but in today's world... Change-Id: I5d638e6f7a2308c50ab12bd901338f02cf426aae
2022-08-05playlist viewer: enable hotkeyChristian Soffke1-5/+6
'File Browser' hotkeys can now be used while browsing a playlist. The manual has been updated to reflect this and to say that the File Browser hotkey works in the context of the database as well (existing behavior) Change-Id: I51b23e82e0fb00772efdb8784db966d454fb2560
2022-08-05add hotkeys for properties and pictureflowChristian Soffke1-2/+2
Change-Id: I16b36dd02f1c2aa186d957c64ed7d239c4c91047
2022-07-12manual: add 'autoupdate bookmarks' to config file optionsChristian Soffke1-0/+2
(from db1b823) Change-Id: I863c0b366ad0c07ebce91da0017e57013fa126b8
2022-06-21Reset settings on button holdWilliam Wilgus1-9/+35
extend this properly to the gigabeast and iriver updated manual entries Change-Id: Ibd1bce8d113193cb3b76f4daf0d6ceb01a2f7585
2022-06-21Rb Manual Fix missing bracketWilliam Wilgus1-3/+4
Fix missing bracket from 7e0492444c38f2ed350016be15b6a4d8ba489bcd g#4568 Change-Id: Iab897ae0c61c7a039a6870980cdb87f5fd33386f
2022-06-21usb: remove "Ask" USB Mode (FS#13317)Aidan MacDonald2-11/+14
USB ask mode is basically a footgun: it can't work on native targets and doesn't work reliably on hosted ones, and it continually produces a slow trickle of problems. FS#13317 gives a rundown of the issues. Removing the setting seems like the best solution for now, since a fix would be pretty involved. This partially reverts 60f581e8f5. The USB Mode setting is left in place so the option can be added back later in a non-buggy way. Change-Id: Ie01b28dd2ed95a31b509a7834d85bac8eb866098
2022-06-20FS#13193 - Add option to disable settings reset on startupWilliam Wilgus2-1/+17
Updated version of the patch originally by user cockroach UNTESTED Ipods?, Iriver H10, I do not own these players so YMMV https://www.rockbox.org/tracker/task/13193 Change-Id: I7924837f582cc5c49ee68c186d6822f577f65147
2022-05-22pictureflow: Fix 'Update Cache' function and update manualChristian Soffke1-4/+3
The artwork cache was previously always rebuilt, even if you had selected the option to update. "Preparing artwork" should be much quicker now after a database update. Change-Id: Ie81486e29d596b52afd21b01ba54c73f1b402be2
2022-05-14apps: Add "keep current track when replacing playlist" settingAidan MacDonald2-1/+10
Add a setting that makes Play and Play Shuffled in the playlist context menu leave the current song (if any) playing when they replace the playlist. Default to on, since this was the behavior of the old "Clear List & Play Next" option. Change-Id: I1340aed5c28bb3244e36d0953b3308ae59681c97
2022-05-14apps: Change playlist context menu behavior, fix FS#13336Aidan MacDonald1-19/+16
Rename the "Clear List & Play" options to simply Play and Play Shuffled, and change their behavior slightly. Previously they would leave the current song playing, but now they will start playing the first song of the new playlist immediately. Shuffle options are now consistently hidden whenever a single file is selected. Fixes FS#13336 -- Play Shuffled is now always displayed where applicable, regardless of playback state. Change-Id: Idd454b4f9ab2c98cda3ce0389add747a3273fb42
2022-05-09manual: Fix up some issues to try and get texlive2021 working ok.Solomon Peachy4-14/+18
Change-Id: I6fd5cfd7f27792cffbd061d96fdc8c852cc85050
2022-04-19Manual: Add Eros Q Native Bootloader download linkDana Conrad1-0/+1
Forgot this in the previous patchset Change-Id: I3f58e31e57e90cf3bc5f4b02a37ac4c99e8e52b4
2022-04-18Manual: Add Eros Q NativeDana Conrad11-107/+286
Here is the PDF this patchset produces: https://www.dropbox.com/s/v1uz8p2fsgsz1ng/rockbox-erosqnative-923dabb5cd-220409.pdf?dl=0 Change-Id: I27554cb65a6498a6ccb714d4f93f25264b516e99
2022-04-08Manual: Update PictureFlowChristian Soffke2-28/+89
- Update the manual entry for PictureFlow with the latest features and fix keymap - Strongly suggest enabling the database's "Load to RAM" feature (in my experience, this can lead to a ~60x speedup when building the album index) - Suggest enabling the dircache, as it can noticeably improve the loading times for album art. Change-Id: I12c7ce5d5388159da1790fc125f2e20bb78dbf96
2022-04-08Manual: Update fiiom3k keymapChristian Soffke2-12/+12
Change-Id: I98250262a3ec17edcd35487411c42db6bfd5ce66
2022-03-26Last FM scrobbler remove manual entryWilliam Wilgus1-12/+0
Change-Id: Ib49ceac9858c28813c596a38dd5376928330598f
2022-02-07sync clock with RDS timeWolfram Sang2-0/+9
Tested with my SansaClip+. I don't think this will need extra battery but let me know if I am wrong. Change-Id: I287dae134113e0f8a138af68f5087b8ea45b0f4c
2022-02-01misc: Add 'mpga' as a valid file extensionSolomon Peachy2-65/+65
Some podcasts use this, apparently. Change-Id: I24f372ed760f15e204dba3a99552ad3b6a051515
2022-01-30Fix manual build on some targets (76a2a00732)Solomon Peachy1-3/+2
Change-Id: Iaf87d11cd2ce3faf9b98da0a1978dfd3fcdb2ba8
2022-01-30manual: reenable "Configuring the Theme" for devices without remote LCDWolfram Sang1-0/+1
Commit 0c4f89370d ("[2/4] get rid of HAVE_LCD_CHARCELLS") missed a closing brace which disabled the above topic in my Sansa Clip+ manual. Change-Id: Ic7a104757f258a37628645389dbfa1b6c8499415
2022-01-29FiiO M3K: audio recordingAidan MacDonald1-0/+12
Recording works now, although I'm sure there will be a few things that need fine-tuning. A major issue is that writing to the SD card creates noticable interference, which happens on the original firmware too but seems worse under Rockbox. (Since Rockbox waits until RAM fills up before writing data, the interference will only be heard on >50 MiB recordings.) Change-Id: I5561dd9668c3bdd34e92f34ef50848aef8c0b7eb
2022-01-22Option to switch off album art or to prefer file over embeddedChristian Soffke2-0/+12
Large embedded album art can cause pauses during playback or when skipping between tracks, especially on older devices, but embedded art is currently loaded even when separately stored smaller image files would be available. A workaround is to remove large album art from the metadata of files. This now adds a setting to either turn off loading of album art completely, or to prefer loading the album art from a separate image file and thus ignore the embedded versions. Change-Id: I22fb581abf56072e35e6c29d72e553747ec1a96a