Amberol

This is a modified version of amberol. The original version is here. This version has added features that you can enable/disable in Cargo.toml.

Features

shortcuts

Change the default keyboard shortcuts.

New Shortcuts:

• Control+b': toggle the playlist
• r: toggle shuffling songs
• c: toggle repeat mode
• Arrow left: seek forward
• Arrow right: seek backward
• n: next
• p: previous
• k and Space: play/pause

auto_restore_playlist

Automatically restore the playlist when launching Amberol.

song_duration

Display the total song duration instead of the remaining time.

volume_shortcuts

Add keyboard shortcuts to control the volume:

• Arrow up: raise the volume
• Arrow down: decrease the volume
• m: Toggle mute

autoplay

Automatically play songs when opening Amberol or when adding new songs.

last_played_song

Remember the last played song when restoring the playlist.

better_seek

Seek forward and backward are smoother with the keyboard.

bigger_cover

If the window is big enough the cover of the song will be twice bigger.

music_dir

The file dialog used for adding new songs open in the music folder by default instead of the recent folder.

cover_per_song

Display the right cover for each song in the same album if they are different. This feature will increase a bit the loading time.

Default README

A small and simple sound and music player that is well integrated with GNOME.

Amberol aspires to be as small, unintrusive, and simple as possible. It does not manage your music collection; it does not let you manage playlists, smart or otherwise; it does not let you edit the metadata for your songs; it does not show you lyrics for your songs, or the Wikipedia page for your bands.

Amberol plays music, and nothing else.

Flatpak builds

The recommended way of installing Amberol is through Flatpak. If you don't have Flatpak installed, you can get it from the Flatpak website.

You can install stable builds of Amberol from Flathub by using this command:

flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak install flathub io.bassi.Amberol

Getting in touch

If you have questions about Amberol, you can join the #amberol:gnome.org channel on Matrix, or use the GNOME Discourse instance.

Contributing

Please, see the contribution guide if you wish to report and issue, fix a bug, or implement a new feature.

How to obtain debugging information

Run Amberol from your terminal using:

RUST_BACKTRACE=1 RUST_LOG=amberol=debug flatpak run io.bassi.Amberol

to obtain a full debug log.

Translations

Amberol is translated on the GNOME translation platform.

You should contact the coordinator of the localization team for your language if you have questions.

For more information, please see the GNOME Translation Project wiki.

Code of conduct

Amberol follows the GNOME project Code of Conduct. All communications in project spaces, such as the issue tracker or Discourse are expected to follow it.

Why is it called "Amberol"?

The name comes from the the Blue Amberol Records, a type of cylinder records made of (blue) nitrocellulose, capable of playback durations of around four minutes, just about the length of the average song since 1990.

Copyright and licensing

Copyright 2022 Emmanuele Bassi

Amberol is released under the terms of the GNU General Public License, either version 3.0 or, at your option, any later version.