nichrosia/musyn

Internet-to-storage music synchronizer.

Musyn

A tool to more easily synchronize online repositories of music to local storage.

Quickstart

1. Install musyn. Currently, the only option is by using Nimble with the source code, but I might turn this into a Nimble package at some point.

nimble install

2. Initialize a repository.

musyn init

3. Create a source. Currently, the only available type is YouTube, which can be input as "youtube" or "yt".

musyn src-new <name> <type>

4. Configure required settings. Currently, the only options for YouTube are playlist and channel IDs.

musyn src-mod <name> id <id>
musyn src-mod <name> id_type (playlist | channel)
musyn src-mod <name> file_type <audio file extension>

5. Synchronize.

musyn sync

All in one, with Qumu's music as an example, that would be:

musyn init

musyn src-new Qumu yt

musyn src-mod Qumu id PL0PCz_ViBzWZPPjiVmYXZWHbXkGpbQNA6
musyn src-mod Qumu id_type playlist
musyn src-mod Qumu file_type mp3

musyn sync

Further reading

Simply running musyn or musyn help will display an overview of the available commands. For more detail, simply run musyn help <command>, or musyn help :<concept> for other information, like available source types or source settings.

musyn's Issues

Don't use a custom argument parser

Instead, use something like nim-argparse or cligen.

500 Internal Server Error with `musyn sync`

On random occasion, while running musyn sync, a 500 error is raised, exiting the program.

The log, specifically:

/path/to/current/directory $ musyn sync --debug
[E] error in execution! saving existing songs to index...
[D] message:
500 Internal Server Error

About this:

• the entire Nim error should be shown, as well as the URL used, as merely [D] message: 500 Internal Server Error is rather hostile to debugging.
• multiple Invidious instances should be used, so that another can be used if one fails.

deletions listed in the `status` command are never performed when using `sync`

In the code, it only iterates through the additions.

`--skip` is required to sync when one or more videos are private

Misbehavior

As private videos can't be accessed without authentication, they raise an error, which crashes musyn if --skip is not used.

Expected behavior

Private videos are automatically skipped without errors or requiring --skip.

`musyn status` and `sync` are extremely slow

A very visible pause in execution exists between each entry from status, and sync seems to just hang for several seconds before doing anything, especially if a large number of repositories exist.

Some things in the code that seem problematic:

• a new HttpClient is instantiated every function call. That obviously needs to be changed.
• no hashing of any kind seems to exist. Instead, for every single time we check the entire length of the playlist, making lots of requests in the process. Although, at the same time, this may not be possible, depending on whether the YT API provides any unique value that changes every time the playlist is updated.