Skip to main content

An unofficial ViMusic CLI that enhances playlist management.

Project description

PyPi Python versions License

vimanager

A command-line tool written in Python that enhances the management of your playlists in the ViMusic application.

NOTE: This is an unofficial tool that is not maintained nor run by the developers of ViMusic.

Along side with its various other functionalities, a few of its key features are allowing you to move your Spotify playlists to ViMusic, and downloading your playlist tracks to your device.

Due to other dependencies being needed, these features are not natively supported. See All features for more information.

Installing and updating

Python 3.8 or higher is required. Depending on the version you wish to install, run the appropriate command.

Once installed, run vimanager --help for a help menu and more information on how to use the playlist manager.

Note that on some systems, you might have to replace python3 with py -3.

Stable

python3 -m pip install -U vimanager-cli

Development

python3 -m pip install -U git+https://github.com/Lee-matod/vimanager-cli

All features

Installing using this command includes the optional features listed below, which can also be installed seperatly.

python3 -m pip install -U "vimanager-cli[full]"

Spotify Support

Copy your playlists from Spotify to ViMusic.

python3 -m pip install -U "vimanager-cli[spotify]"

Download Support

Download the tracks in your playlist to your device.

python3 -m pip install -U "vimanager-cli[download]"

FFmpeg is required for this feature. If you do not have it installed on your device, see below for guidance.

Downloading FFmpeg

  • Windows Tutorial
  • MacOS - brew install ffmpeg
  • Linux - sudo apt install ffmpeg or whichever package manager you use.

Getting your playlists as a database file

All of the feature in this tool require a database that has your playlists stored in it. You can easily obtain this file through the ViMusic application thanks to their backup feature. Follow the steps below.

  1. Open ViMusic.
  2. Open the Configuration menu.
  3. Go to the Database tab.
  4. Click on Backup.
  5. Save the backup file to the desired destination.

Similarly, once you have finished editing your playlists, click on Restore instead of Backup and select the file you edited to apply the changes made.

License

This project is Licensed under the MIT License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vimanager-cli-0.2.0.tar.gz (21.2 kB view hashes)

Uploaded Source

Built Distribution

vimanager_cli-0.2.0-py3-none-any.whl (33.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page