Download version 1.4.8: Windows or Linux

Example: Rhythmbox MP3 Collection Manager

This project has 107 classes.

This is a full-blown MP3 collection manager that is designed to work in conjunction with the Rhythmbox media player and has a number of features of particular interest to Tango DJs.

Manger Syntax

el_rhythmbox -manager -config <task-configuration>.pyx

Features

Integrates with the GNOME desktop and the GNOME terminal so you can drag and drop task configuration files on to either a XDG desktop launcher or the GNOME terminal.
Automatically add album art to MP3 files from a directory based on album name or artist name.
Collate songs into a directory structure according to song tags:

<genre>/<artist-name>/<song-title>.<unique id>.mp3

Import videos in various formats as MP3 files automatically adding ID3 tags according to folder location. Includes facility for mapping video segments to individual MP3 files.
Replace songs marked as duplicated, updating all playlists and removing replaced song from collection.
Display all ID3 tag comments
Create tango cortinas to act as breaks between a set of dance songs.
Delete all ID3 tag comments except for the Rhythmbox 'c0' comment. (Gets rid of iTune identifiers etc.)
Remove all UFID fields from ID3 tags
Store playlists in a special format that can be easily edited in a text editor to add DJ event information.
Publish playlists augmented with DJ event information to a website using an Evolicity HTML template.
Display MusicBrainz info for any songs that have it.
Display songs with incomplete TXXX ID3 tags (User defined text).
Archive songs placed in a special "Archive" playlist. This removes them from the main Rhythmbox collection but does not delete them.
Append field "album-artist" into main 'c0' comment.
Replace 'c0' comment with album-artist info
Synchronize all (or selected genres) of music with connected device.
Export all playlists and associated MP3 to external device
Has a trick where the beats-per-minute ID3 field can be used to generate a silent pause after particular songs in a playlist.
Writes a unique audio signature into the MusicBrainz track id to facilitate foolproof device synchronization.

Manual

For details on how to use, read the source documentation notes in class RHYTHMBOX_MUSIC_MANAGER_APP.

Download

Download the latest executable for Ubuntu 14.04 or Linux Mint 17.x at the bottom of this page. You also need the following command line tools to be installed: sox, swgen, avconv, lame, gvfs-mount.

Warning: Use at your own risk. It is recommended that you have a backup of your MP3 collection and rhythmbox configuration files (Usually in $HOME/.local/share/rhythmbox). The developer does not take any responsibility for any data loss that may occur as a result of using el_rhythmbox.

Directory: example/manage-mp3/source

. /rhythmbox/constants

. /rhythmbox/constants/common

. /rhythmbox/database

. /rhythmbox/database/entry

. /rhythmbox/device

. /rhythmbox/device/sync

. /rhythmbox/manager

. /rhythmbox/manager/config

. /rhythmbox/manager/task

. /rhythmbox/manager/task/ID3/edit

. /rhythmbox/manager/task/ID3/query

. /rhythmbox/manager/task/export

. /rhythmbox/manager/task/import

. /rhythmbox/manager/task/manage

. /rhythmbox/manager/task/playlist

. /rhythmbox/manager/task/tango

. /rhythmbox/playlist

[ . ]

APPLICATION_ROOT

Application root

BUILD_INFO

Build specification

Further Information

Click on class link to see notes.

apps

AUTOTEST_APP

Finalized executable test sets

Further Information

Click on class link to see notes.

GENERATE_RBOX_DATABASE_FIELD_ENUM_APP

Sub-application to generate class RBOX_DATABASE_FIELD_ENUM from C source file rhythmdb.c

Further Information

Click on class link to see notes.

ID3_EDITOR_APP

Id3 editor app

MP3_AUDIO_SIGNATURE_READER_APP

Mp3 audio signature reader app

RHYTHMBOX_MUSIC_MANAGER_APP

MP3 manager for the Rhythmbox media player. The manager executes tasks defined by task configuration written in Pyxis format (an XML analog). See example/manage-mp3/doc/tasks for configuration examples.

See the class hierarchy with RBOX_MANAGEMENT_TASK as it's root.

Usage:

el_rhythmbox -manager -config <task-configuration>

The -manager switch is needed to select a sub application from the main application. See class APPLICATION_ROOT.

Further Information

Click on class link to see warning and instructions.

TANGO_MP3_FILE_COLLATOR_APP

Application to collate a Tango MP3 collection into a directory structure using any available ID3 tag information and renaming the file according to the title and a numeric id to distinguish duplicates.

<genre>/<artist>/<title>.<id>.mp3

command

DETECT_RHYTHMBOX_COMMAND

Detect rhythmbox command

ID3_EDITOR

ID3 editor

TANGO_MP3_FILE_COLLATOR

Tango mp3 file collator

command/support

ID3_TAG_INFO_ROUTINES

ID3 tag edits

rhythmbox/constants

M3U_PLAY_LIST_CONSTANTS

M3U play list constants

RBOX_ALBUM_FIELDS_ENUM

Album fields enumeration from rhythmdb.c for Rhythmbox version 3.0.1

RBOX_ARTIST_FIELDS_ENUM

Artist fields enumeration from rhythmdb.c for Rhythmbox version 3.0.1

RBOX_COMPOSER_FIELDS_ENUM

Composer fields enumeration from rhythmdb.c for Rhythmbox version 3.0.1

RBOX_DATABASE_FIELD_ENUM

Fields from rhythmdb.c for Rhythmbox version 3.0.1

Further Information

Click on class link to see notes.

RBOX_DATABASE_FIELD_TYPES

Field types in `rhythmdb.c for Rhythmbox version 3.0.1

RBOX_MUSICBRAINZ_FIELDS_ENUM

MusicBrainz fields enumeration from rhythmdb.c for Rhythmbox version 3.0.1

RBOX_REPLAYGAIN_FIELDS_ENUM

Replaygain fields enumeration from rhythmdb.c for Rhythmbox version 3.0.1

RBOX_SHARED_DATABASE_FIELD_ENUM

Shared instance of RBOX_DATABASE_FIELD_ENUM

rhythmbox/constants/common

RHYTHMBOX_CONSTANTS

Rhythmbox constants

rhythmbox/database

RBOX_DATABASE

Database of all Rhythmbox songs, playlists, radio entries and ignored entries. It is read from these files:

$HOME/.local/share/rhythmbox/rhythmdb.xml
$HOME/.local/share/rhythmbox/playlists.xml
$HOME/Music/Playlists/*.pyx

The *.pyx ones are playlists which have been saved using the update_dj_playlists task.

Note that this database save modifications to songs and playlists.

RBOX_PLAYLIST

Rhythmbox playlist

RBOX_PLAYLIST_ARRAY

Rhythmbox playlist array

SHARED_DATABASE

Shared access to instance of class conforming to RBOX_DATABASE

SONG_IN_PLAYLIST_QUERY_CONDITION

Song in playlist query condition

SONG_QUERY_CONDITIONS

Song query conditions for use with EL_CHAIN routines

query
query_if
inverse_query_if

Further Information

Click on class link to see descendants.

rhythmbox/database/entry

RBOX_CORTINA_SONG

Rbox cortina song

RBOX_IGNORED_ENTRY

Rhythmbox ignored file entry (used for Pyxis playlists)

RBOX_IRADIO_ENTRY

Rhythmbox radio station entry

RBOX_IRADIO_FIELDS

Fields mapping to Rhythmbox XML Internet Radio station data

Example

<entry type="iradio">
   <title>WSUM 91.7 FM (University of Wisconsin)</title>
   <genre>College Radio</genre>
   <artist></artist>
   <album></album>
   <location>http://vu.wsum.wisc.edu/wsumlive.m3u</location>
   <date>0</date>
   <media-type>application/octet-stream</media-type>
</entry>

RBOX_PLAYLIST_ENTRY

Entry indicating location of external playlist in Pyxis format

RBOX_SONG

Object representing Rhythmbox 3.0.1 song entry in rhythmdb.xml

See field enumeration class RBOX_DATABASE_FIELD_ENUM

RBOX_SONG_FIELDS

Fields mapping to Rhythmbox XML song data

Example Entry

<entry type="song">
   <title>L'Autre Valse d'Am&#xE9;lie</title>
   <genre>Vals (Modern)</genre>
   <artist>Yann Tiersen</artist>
   <album>Le Fabuleux Destin d'Am&#xE9;lie Poulain</album>
   <comment>Composer: Yann Tiersen</comment>
   <album-artist>Composer: Yann Tiersen</album-artist>
   <track-number>6</track-number>
   <duration>93</duration>
   <file-size>2244105</file-size>
   <location>file://$MUSIC/Vals%20(Modern)/Yann%20Tiersen/L'Autre%20Valse%20d'Am%C3%A9lie.02.mp3</location>
   <mtime>1335094508</mtime>
   <first-seen>1358180915</first-seen>
   <last-seen>1382259840</last-seen>
   <bitrate>192</bitrate>
   <date>730486</date>
   <media-type>audio/mpeg</media-type>
   <mb-trackid>CF22F4A6:D9D3:B4A6:674B:3866B6129A3C</mb-trackid>
   <mb-artistsortname>Tiersen, Yann</mb-artistsortname>
   <composer>Yann Tiersen</composer>
</entry>