CLI usage - WilliamNT/tunesynctool GitHub Wiki

You can use tunesynctool from the CLI. This is especially useful if you don't want to work with Python or have other special needs.

Warning

  • Consider the CLI part of the project experimental. I'm still figuring things out. Thank you for your patience. Certain features of the Python package may be unavailable or implemented slightly differently.
  • Unlike when using the Python package directly, the CLI doesn't support operations between different accounts on the same service. This will be addressed down the road, but for now please use the Python package.

Commands

Tip

Too lazy to type your own commands? Click here to generate commands automatically. This website is from the author of tunesynctool.

Help

Use tunesynctool --help to list all commands. You can also use tunesynctool commandname --help to get help for individual commands.

Authentication (configuration)

To provide authentication and other configuration options to the CLI tool, you must pass any of the options listed on the Configuration page before the command name. See the example for further clarification.

tunesynctool <CLI TOOL CONFIGURATION OPTIONS> <COMMAND NAME> <COMMAND OPTIONS>

You only need to use relevant options for your command. You don’t have to supply all of them; just the ones you need.

Transfer (mirror) playlist

tunesynctool transfer --from <SERVICE NAME> --to <SERVICE NAME> <PLAYLIST ID> <OTHER OPTIONS>

Playlist ID refers to the ID of the playlist you want to transfer over to the target service.

Example:

tunesynctool --spotify-client-id <CLIENT_ID> --spotify-client-secret <CLIENT_SECRET> --subsonic-base-url http://localhost --subsonic-port 4533 --subsonic-username <USERNAME> --subsonic-password <PASSWORD> transfer --from spotify --to subsonic <PLAYLIST_ID>

Optional flags:

  • --preview flag: to check the matching success rate without actually creating a new playlist

Sync playlists (add missing songs)

tunesynctool sync --from <SERVICE NAME> --to <SERVICE NAME> --from-playlist <PLAYLIST ID> --to-playlist <PLAYLIST ID> <OTHER OPTIONS>

To use this command, you’ll need to provide a source service and playlist ID, as well as a target service and playlist ID.

Example:

tunesynctool sync --from deezer --to spotify --from-playlist <DEEZER PLAYLIST ID> --to-playlist <SPOTIFY PLAYLIST ID> --misses

Optional flags:

  • --preview flag: to check the matching success rate without actually updating the target playlist
  • —-diff flag: to list the tracks that are present in the source playlist but absent from the target playlist.
  • —-misses flag: similar to the —-diff flag (both can be used simultaneously), but only displays the ones that could not be identified on the target streaming service
⚠️ **GitHub.com Fallback** ⚠️