https://github.com/nickatnight/chaptify
:book: :arrow_right: :loud_sound: Create Spotify playlists from the audio of chapter enabled YouTube videos
https://github.com/nickatnight/chaptify
chapters python spotify spotify-playlist youtube
Last synced: 6 months ago
JSON representation
:book: :arrow_right: :loud_sound: Create Spotify playlists from the audio of chapter enabled YouTube videos
- Host: GitHub
- URL: https://github.com/nickatnight/chaptify
- Owner: nickatnight
- Created: 2021-05-15T01:38:28.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2022-08-23T04:17:30.000Z (about 3 years ago)
- Last Synced: 2025-02-12T22:19:46.426Z (8 months ago)
- Topics: chapters, python, spotify, spotify-playlist, youtube
- Language: Python
- Homepage:
- Size: 76.2 KB
- Stars: 2
- Watchers: 3
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Photo: https://daily.bandcamp.com
# chaptify :closed_book: :speaker:
A simple cli to create Spotify playlists from the audio of [chapter](https://support.google.com/youtube/answer/9884579?hl=en) enabled YouTube videos
## Reason?
I needed an automated process to transfer 80s synthwave mixes I listen to from [YouTube](https://www.youtube.com/watch?v=2b9AqJimM-0), most of which were chapter enabled (new video feature from YT), to Spotify playlists.
## Install (edit mode) Python 3.9+
This package relies on `spotipy`, a lightweight python wrapper for Spotify api. See their [docs](https://spotipy.readthedocs.io/en/latest/) for installation or Spotify [developer](https://developer.spotify.com/documentation/general/guides/) guide for obtaining api keys
1. clone this repo `$ git clone git@github.com:nickatnight/chaptify.git` and `cd chaptify`
2. export ENV vars
```shell
$ export SPOTIFY_CLIENT_SECRET=
$ export SPOTIFY_CLIENT_ID=
$ export SPOTIFY_REDIRECT_URI= # optional...defaults to http://localhost:8321
```
3. install in editable mode `$ pip install -e .`
4. run `$ chaptify https://www.youtube.com/watch\?v\=Pz1a9MM-Vn4`
### Note
* SPOTIFY_REDIRECT_URI environment variable must match the redirect URI added to your application in your [Dashboard](https://developer.spotify.com/dashboard/applications) , this URI does not need to be accessible
* on first use, `spotipy` will spin up a temporary web server on whatever port is specified above to automatically handle the oauth redirect
## Usage
```bash
Usage: chaptify [OPTIONS] URL
Youtube video link URL
Options:
-a, --append TEXT Append to a playlist (by name).
--help Show this message and exit.
```
## Development
This project uses [Poetry](https://python-poetry.org/docs/#osx--linux--bashonwindows-install-instructions) to manage dev environment. Once installed:
1. follow steps 1-2 from above
2. install packages with `poetry install`
3. black `poetry run black .`
4. flake8 `poetry run flake8`
5. test `poetry run pytest --cov=chaptify tests/`
6. build sdist `poetry build --format sdist`
7. create new setup.py
```shell
$ tar -xvf dist/*-`poetry version -s`.tar.gz -O '*/setup.py' > setup.py
```
## Limitations
* obviously, this tool is limited to whats available on Spotify
* only supports US market
* works best with title tracks with variations of "name - artist" eg Rosentwig - Journey
* there is no fancy algorithm or deep learning technique when using spotify search, just fetch me the first hit
## TODO
Integrate with new libs