| A desktop app created to store and manage locally data from YouTube playlists. It can pull information from YouTube site and save it to json file, perform updates on json archives by adding or removing positions from the playlists, app can display all mismatches and missing videos from archive and from playlist on YT. Archive can be also exported to Spotify. |
Note
For detailed description of everything related to the project see Wiki. Treat ReadMe file only as a brief guide.
User needs to specify its credentials in .env file.
- Developer Key to YouTube API
- Spotify Client ID (
optional, only if exporting to Spotify is desired) - Spotify Client Secret ID (
optional, only if exporting to Spotify is desired) - Spotify Redirect URL (
optional, only if exporting to Spotify is desired)
KEY="Your Developer Key to YouTube API"
SPOTIFY_CLIENT_ID = 'Your Spotify Client ID'
SPOTIFY_CLIENT_SECRET = 'Your Spotify Client Secret ID'
SPOTIFY_REDIRECT_URI = 'Your Spotify Redirect URL'
Developer keys can be obtained here:
YouTube for Developers
Spotify for Developers
Python 3.x and following libraries: googleapiclient, spotipy, dotenv, tkinter. Also see Permissions.
To clone this repository, use the following command:
(git clone https://github.com/Eques72/PlaylistArchiver.git)
To download ZIP with the project use this link:
Project ZIP
- Open Terminal and navigate to the project directory.
- Install dependencies if necessary (See Preconditions)
- Run the CLI tool with the appropriate command:
python main_cli.py --mode <1, 2 or 3> --single --url <URL to a playlist or channel ID> --path <Input file or output directory>
Eg:python main_cli.py --mode 1 --single --url https://www.youtube.com/playlist?list=PLbpi6ZahtOH4e5qqR_-Fz0fx64qxYPI5W --path C:\Users\user\Desktop\
- --mode - Accepts numbers 1, 2 and 3. 1 opens app in 'Create new Archive' mode, 2 opens app in 'Update Archive' mode, 2 opens app in 'Export to Spotify' mode,
- --single - Optional flag that can be used in mode 1, when provided, program expects playlist URL in --url flag, when absent program expects channel id instead,
- --url - must be provided in mode 1, should contain an URL to a public or non-public playlist or valid channel id,
- --path - In mode 1 path should specify an writable output directory, in mode 2 and 3 path should point to a json archive file created in mode 1,
- --help - Will show all available flags.
- Ensure you have a compatible OS and dependencies installed.
- Open Terminal and navigate to the project directory.
- Run the GUI app with the appropriate command:
python main.py - Follow the on-screen instructions to use the GUI.
If you're interested in creating custom frontend for this application, file PlaylistManager has all public methods that are needed to introduce all present functionalities to your app, both CLI and GUI may serve as an example of usage.
Files created by the application should not be tinkered with as this may lead to them being unreadable to the app.
Want to contribute?
To fix a bug or enhance an existing functionalities, follow these steps:
- Fork the repo
- Create a new branch (
git checkout -b new-feature) - Make the changes
- Commit your changes (
git commit -am 'New improvement feature, added X...') - Push to the branch (
git push origin new-feature) - Create a Pull Request
If you find a bug, please open an issue here by including your search query and the expected result.
If you'd like to request a new function, do so by opening an issue here.
MIT © Eques72