Skip to main content

Application to upload songs to YouTube

Project description



Convert audio files to videos and upload them to YouTube automatically.



  • Extracts album covers from audio files
  • Extracts other metadata which can be used in template strings for the video title/description etc.
  • Can concatenate songs to upload an album as a single video
  • Can upload an album as a playlist of multiple videos
  • Does not use official YouTube API; can upload up to 50-100 videos per day
  • Does not re-encode audio before uploading


  • FFmpeg version 6.1+ is required to convert songs into videos
  • Firefox and geckodriver (or Chrome and Chromedriver) are required to upload to YouTube
  • Make sure FFmpeg and geckodriver/chromedriver are both in your PATH environment variable
  • If you have a package manager you can install through that instead. e.g. with Scoop:
scoop install ffmpeg
scoop install geckodriver


PyInstaller binary

Download the latest release for your platform here, unzip the archive, and run the songs-to-youtube executable.

Install from PyPI

$ pip install songs-to-youtube
$ songs-to-youtube

Run from source

  1. Have Python version 3.8-3.12 installed, and poetry
  2. Download the source code
  3. Install required Python modules with poetry install
  4. Run the program with poetry run songs-to-youtube

Installing certificates

On your first run you may get an error which says Was not able to load Have you installed the certificate at {cert_path} ?. If this happens you should follow the instructions at to install the certificate at the given path.


  • Before you upload any videos, you must sign in to a YouTube account (File > Settings > Add new user)
  • You can drag and drop songs on the main window to add them to the queue. The order in which they are uploaded goes from top to bottom
  • You can also drag and drop images onto a song's current album art to change it
  • Make sure the output file extension stays as .mkv
  • The characters < and > will be replaced with fullwidth versions in titles and descriptions, as YouTube does not allow these symbols
  • Video titles and descriptions longer than YouTube allows will be truncated (100, and 5000 characters respectively)

Template strings

Write ~{key} in any text field and it will be replaced with an appropriate value. If no value exists for that key, it will not be replaced. To see the available keys, right click on an album or song and select "View metadata." Here are some useful values:

Song metadata

  • ~{song_dir} - directory of the input audio file
  • ~{song_file} - file name of the input audio
  • ~{album}
  • ~{artist}
  • ~{title}
  • ~{date}
  • ~{comment}
  • ~{description}

Album metadata

  • ~{album_dir} - directory of the album
  • ~{timestamps} - special key that generates timestamps based on song lengths. they will only be generated when concatenating songs into a single video
  • ~{song.albumartist} - name of the album's artist (usually) The first song of an album can have its keys accessed by the album by prefixing the key with song.


Optional keys / preference ordering

A template string of the form ~{a|b|c} will be replaced with the value of a if it exists, otherwise the value of b if it exists, and so on. Keys may not contain the character |

String literals

A template string of the form ~{a|"hello"} will be replaced with the value for a if it exists, otherwise it will be replaced with hello. String literals may not contain the character |. They may contain " though, e.g. ~{""hello""} will be replaced with "hello"

Safe filenames

Any key can be surrounded by < and > and the value of that key will be made safe to use as a filename. e.g. ~{<song.album>}.mkv where song.album is ~{:¬Þ} will be replaced with ____Þ_.mkv

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

songs_to_youtube-0.13.0.tar.gz (99.6 kB view hashes)

Uploaded Source

Built Distribution

songs_to_youtube-0.13.0-py3-none-any.whl (108.9 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