swee/youtubevideosorter
1
0
Fork 0
Code Issues Pull requests Releases 3 Activity Actions
Simple tool to sort videos with directories by channel
18 commits 1 branch 3 tags 50 KiB
  • Python 100%
Find a file
Exact
swee 370c04ad29 Update pyproject.toml
2025-09-17 07:29:58 -07:00
.forgejo/workflows Add .forgejo/workflows/python-publish.yml 2025-08-22 22:43:41 -07:00
youtubevideosorter Update youtubevideosorter/cli.py 2025-09-17 07:27:36 -07:00
.gitignore Initial commit 2025-08-22 21:37:32 -07:00
LICENSE Initial commit 2025-08-22 21:37:32 -07:00
pyproject.toml Update pyproject.toml 2025-09-17 07:29:58 -07:00
README.md Update README.md 2025-09-16 20:25:54 -07:00

README.md

YouTube Video Sorter

Simple tool to sort videos with directories by channel

How to use?

What you need:

  • Python 3
  • A directory full of videos downloaded with yt-dlp
  • A YouTube API key

Installation

$ pipx install youtubevideosorter
Getting an API key

Go to Google Cloud Console, create a new project if needed

In the "Quick Access" section, click "APIs & Services"

Click the "+ Enable APIs & services" button

Search and enable "YouTube Data API v3"

On the right side of the screen, click the "Credentials" section, click "+ Create credentials" and click "API key"

Now you have your API key!

Usage

Make sure your current working directory is the directory full of videos.

$ ytvs [api key]

Now your videos will be sorted with this directory structure:

  • Channel Name (@handle)
    • Shorts
      • Some Short [video id].mp4
    • Some video [video id].mp4