Rosé is a music manager for Unix-based systems. Rosé provides a virtual FUSE filesystem for managing your music library and various functions for editing and improving your music library's metadata and tags.
Rosé manages a source directory of music releases. Given the following source directory:
source/
├── !collages
│ └── Road Trip.toml
├── !playlists
│ └── Shower.toml
├── BLACKPINK - 2016. SQUARE ONE
│ ├── 01. WHISTLE.opus
│ ├── 02. BOOMBAYAH.opus
│ └── cover.jpg
├── BLACKPINK - 2016. SQUARE TWO
│ ├── 01. PLAYING WITH FIRE.opus
│ ├── 02. STAY.opus
│ ├── 03. WHISTLE (acoustic ver.).opus
│ └── cover.jpg
├── LOOΠΔ - 2017. Kim Lip
│ ├── 01. Eclipse.opus
│ ├── 02. Twilight.opus
│ └── cover.jpg
├── LOOΠΔ ODD EYE CIRCLE - 2017. Mix & Match
│ ├── 01. ODD.opus
│ ├── 02. Girl Front.opus
│ ├── 03. LOONATIC.opus
│ ├── 04. Chaotic.opus
│ ├── 05. Starlight.opus
│ └── cover.jpg
└── NewJeans - 2022. Ditto
├── 01. Ditto.opus
└── cover.jpgRosé produces the following virtual filesystem (duplicate information has been omitted).
virtual/
├── 1. Releases/
│ ├── BLACKPINK - 2016. SQUARE ONE - Single/
│ │ ├── 01. BLACKPINK - WHISTLE.opus
│ │ ├── 02. BLACKPINK - BOOMBAYAH.opus
│ │ └── cover.jpg
│ ├── BLACKPINK - 2016. SQUARE TWO - Single/...
│ ├── LOOΠΔ - 2017. Kim Lip - Single [NEW]/...
│ ├── LOOΠΔ ODD EYE CIRCLE - 2017. Mix & Match - EP/...
│ └── NewJeans - 2022. Ditto - Single/...
├── 2. Releases - New/
│ └── LOOΠΔ - 2017. Kim Lip - Single [NEW]/...
├── 3. Releases - Recently Added/
│ ├── [2023-10-25] LOOΠΔ - 2017. Kim Lip - Single/...
│ ├── [2023-10-01] LOOΠΔ ODD EYE CIRCLE - 2017. Mix & Match - EP/...
│ ├── [2023-02-28] NewJeans - 2022. Ditto - Single/...
│ ├── [2022-08-22] BLACKPINK - 2016. SQUARE TWO - Single/...
│ └── [2022-08-10] BLACKPINK - 2016. SQUARE ONE - Single/...
├── 4. Artists/
│ ├── BLACKPINK/
│ │ ├── BLACKPINK - 2016. SQUARE ONE - Single/...
│ │ └── BLACKPINK - 2016. SQUARE TWO - Single/...
│ ├── LOOΠΔ/
│ │ ├── LOOΠΔ - 2017. Kim Lip - Single [NEW]/...
│ │ └── LOOΠΔ ODD EYE CIRCLE - 2017. Mix & Match - EP/...
│ ├── LOOΠΔ ODD EYE CIRCLE/
│ │ └── LOOΠΔ ODD EYE CIRCLE - 2017. Mix & Match - EP/...
│ └── NewJeans/
│ └── NewJeans - 2022. Ditto - Single/...
├── 5. Genres/
│ ├── Big Room House/
│ │ └── BLACKPINK - 2016. SQUARE ONE - Single/...
│ ├── Contemporary R&B/
│ │ ├── NewJeans - 2022. Ditto - Single/...
│ │ └── LOOΠΔ - 2017. Kim Lip - Single [NEW]/...
│ ├── Future Bass/
│ │ └── LOOΠΔ ODD EYE CIRCLE - 2017. Mix & Match - EP/...
│ ├── Dance-Pop/
│ │ ├── BLACKPINK - 2016. SQUARE ONE - Single/...
│ │ ├── BLACKPINK - 2016. SQUARE TWO - Single/...
│ │ ├── LOOΠΔ - 2017. Kim Lip - Single [NEW]/...
│ │ └── LOOΠΔ ODD EYE CIRCLE - 2017. Mix & Match - EP/...
│ └── K-Pop/
│ ├── BLACKPINK - 2016. SQUARE ONE - Single/...
│ ├── BLACKPINK - 2016. SQUARE TWO - Single/...
│ ├── LOOΠΔ - 2017. Kim Lip - Single [NEW]/...
│ └── LOOΠΔ ODD EYE CIRCLE - 2017. Mix & Match - EP/...
├── 6. Labels/
│ ├── ADOR/
│ │ └── NewJeans - 2022. Ditto - Single/...
│ ├── BlockBerry Creative/
│ │ ├── LOOΠΔ - 2017. Kim Lip - Single [NEW]/...
│ │ └── LOOΠΔ ODD EYE CIRCLE - 2017. Mix & Match - EP/...
│ └── YG Entertainment/
│ ├── BLACKPINK - 2016. SQUARE ONE - Single/...
│ └── BLACKPINK - 2016. SQUARE TWO - Single/...
├── 7. Collages/
│ └── Road Trip/
│ ├── 1. BLACKPINK - 2016. SQUARE TWO - Single/...
│ └── 2. LOOΠΔ ODD EYE CIRCLE - 2017. Mix & Match - EP/...
└── 8. Playlists/
└── Shower/
├── 1. LOOΠΔ ODD EYE CIRCLE - Chaotic.opus
├── 2. NewJeans - Ditto.opus
├── 3. BLACKPINK - PLAYING WITH FIRE.opus
└── 4. Kim Lip - Eclipse.opusIn addition to a flat directory of all releases, Rosé creates directories based on Date Added, Artist, Genre, and Label. Rosé also provides a few other concepts for organizing your music library:
Rosé's virtual filesystem organizes your music library by the metadata in the music tags. The quality of the virtual filesystem depends on the quality of the tags.
Thus, Rosé also provides a text-based interface for manually modifying metadata and a rules engine for bulk updating metadata to improve the tags of your music library.
The rules engine allows you to pattern match tracks in your music library and apply tag changes to them. For example:
$ rose rules run 'trackartist,releaseartist:^CHUU$' 'replace:Chuu'
CHUU - 2023. Howl/01. Howl.opus
trackartist[main]: ['CHUU'] -> ['Chuu']
releaseartist[main]: ['CHUU'] -> ['Chuu']
CHUU - 2023. Howl/02. Underwater.opus
trackartist[main]: ['CHUU'] -> ['Chuu']
releaseartist[main]: ['CHUU'] -> ['Chuu']
CHUU - 2023. Howl/03. My Palace.opus
trackartist[main]: ['CHUU'] -> ['Chuu']
releaseartist[main]: ['CHUU'] -> ['Chuu']
CHUU - 2023. Howl/04. Aliens.opus
trackartist[main]: ['CHUU'] -> ['Chuu']
releaseartist[main]: ['CHUU'] -> ['Chuu']
CHUU - 2023. Howl/05. Hitchhiker.opus
trackartist[main]: ['CHUU'] -> ['Chuu']
releaseartist[main]: ['CHUU'] -> ['Chuu']Rosé allows you to interact with and script against your music library through a virtual filesystem and through a CLI. A concise list of the features provided by the two interfaces is:
.mp3, .m4a, .ogg (vorbis), .opus, and .flac files[!NOTE] Rosé modifies the managed audio files, even on first scan. If you do not want to modify your audio files, for example because they are seeding in a bittorrent client, you should not use Rosé.
Rosé expects users to be comfortable with the shell. Rosé's documentation and user interface assumes that the reader is familiar with software.
Rosé does not provide a complete music system. The user is expected to compose their own system, with Rosé as one of the pieces.
Rosé is designed for large music libraries. Smaller libraries do not require the power that Rosé offers.
Rosé expects all tracks to be part of a release. Rosé also expects that each release is an immediate subdirectory of the source directory. Rosé will not work with libraries that are collections of unorganized tracks.
Rosé modifies the files that it manages, as early as the first scan (where it writes roseid tags).
Rosé does not maintain a separate database; all changes are directly applied to the managed files.
This is incompatible with files seeded as torrents.
Install Rosé with Nix Flakes. If you do not have Nix Flakes, you can install Nix Flakes with this installer.
Then, to install the latest release of Rosé, run:
$ nix profile install github:azuline/rose/release[!NOTE] The master branch tracks the unstable release, whose documentation may be more up-to-date than the latest release's documentation. You can view the latest release's documentation here.
Most users should install the latest release version of Rosé. However, if you wish to install the
latest unstable version of Rosé, you can do so with the command nix profile install github:azuline/rose/master.
Let's now get Rosé up and running!
Once Rosé is installed, let's first confirm that rose exists and is accessible:
$ rose
Usage: rose [OPTIONS] COMMAND [ARGS]...
A music manager with a virtual filesystem.
Options:
-v, --verbose Emit verbose logging.
-c, --config PATH Override the config file location.
--help Show this message and exit.
Commands:
artists Manage artists.
cache Manage the read cache.
collages Manage collages.
config Utilites for configuring Rosé.
descriptors Manage descriptors.
fs Manage the virtual filesystem.
genres Manage genres.
labels Manage labels.
playlists Manage playlists.
releases Manage releases.
rules Run metadata update rules on the entire library.
tracks Manage tracks.
version Print version.[!NOTE] This quickstart assumes you have a local "source directory" of music releases for Rosé to manage. Each music release must be an immediate child subdirectory of the "source directory."
Great! Next, we'll (1) configure Rosé, (2) mount the virtual filesystem, and finally (3) play music!
Rosé requires a configuration file. On Linux, the configuration file is located at
$XDG_CONFIG_HOME/rose/config.toml, which is typically ~/.config/rose/.config.toml. On MacOS,
the configuration file is located at ~/Library/Preferences/rose/config.toml.
Only two configuration options are required:
# The directory of music to manage.
# WARNING: The files in this directory WILL be modified by Rosé!
music_source_dir = "~/.music-source"
# The mountpoint for the virtual filesystem.
vfs.mount_dir = "~/music"The full configuration specification is documented in Configuration.
Now let's mount the virtual filesystem:
$ rose fs mount
[15:41:13] INFO: Updating cache for release BLACKPINK - 2016. SQUARE TWO
[15:41:13] INFO: Updating cache for release BLACKPINK - 2016. SQUARE ONE
[15:41:13] INFO: Updating cache for release LOOΠΔ - 2017. Kim Lip
[15:41:13] INFO: Updating cache for release NewJeans - 2022. Ditto
[15:41:13] INFO: Updating cache for release LOOΠΔ ODD EYE CIRCLE - 2017. Mix & Match
[15:41:13] INFO: Updating cache for collage Road Trip
[15:41:13] INFO: Updating cache for playlist ShowerRosé emits log lines whenever something significant is occurring. This is expected! The log lines
above come from the rose fs mount command indexing the music_source_dir at startup, in order
to populate the read cache.
The virtual filesystem uses the read cache to determine the available music and its metadata.
It's possible for the cache to get out of sync from the source music files. If that happens, the
rose cache update is guaranteed to resynchronize them. See Maintaining the
Cache for additional documentation on cache updates and
synchronization.
Now that the virtual filesystem is mounted, let's go take a look! Navigate to the configured
vfs.mount_dir, and you should see your music available in the virtual filesystem!
$ cd $vfs_mount_dir
$ ls -1
'1. Releases'
'2. Releases - New'
'3. Releases - Recently Added'
'4. Artists'
'5. Genres'
'6. Labels'
'7. Collages'
'8. Playlists'
$ ls -1 "1. Releases/"
'BLACKPINK - 2016. SQUARE ONE - Single'
'BLACKPINK - 2016. SQUARE TWO - Single'
'LOOΠΔ ODD EYE CIRCLE - 2017. Mix & Match - EP'
'LOOΠΔ - 2017. Kim Lip - Single [NEW]'
'NewJeans - 2022. Ditto - Single'Let's play some music! You should be able to open a music file in your music player of choice.
Mine is mpv:
$ mpv "1. Releases/LOOΠΔ ODD EYE CIRCLE - 2017. Mix & Match - EP/04. LOOΠΔ ODD EYE CIRCLE - Chaotic.opus"
(+) Audio --aid=1 'Chaotic' (opus 2ch 48000Hz)
File tags:
Artist: LOOΠΔ ODD EYE CIRCLE
Album: Mix & Match
Album_Artist: LOOΠΔ ODD EYE CIRCLE
Date: 2017
Genre: K-Pop
Title: Chaotic
Track: 4
AO: [pipewire] 48000Hz stereo 2ch floatpAnd that's it! If desired, you can unmount the virtual filesystem with the rose fs unmount
command.
Rosé alone is not a full-featured music system, and that's the point. You should compose Rosé with other great tools to create the music system that works best for you.
We recommend pairing Rosé with:
You also need not use the complete feature set of Rosé. Everything will continue to work if you only use the virtual filesystem and ignore the metatdata tooling, and vice versa.
Rosé's CLI is also designed to make scripting against your library easy. Operations such as "edit release" and "jump to artist" can be expressed as a bash one-liner and integrated into your file manager.
For additional documentation, please refer to the following files:
Copyright 2023 blissful <blissful@sunsetglow.net>
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.Bug fixes are happily accepted!
However, please do not open a pull request for a new feature without prior discussion. Rosé is a pet project that I developed for personal use. Rosé is designed to match my specific needs and constraints, and is never destined to be widely adopted. Therefore, the feature set will remain focused and small.
Rosé is provided as-is, really!