Have you ever wanted to take a YouTube video on the go with you without needing to download the video for offline viewing in the YouTube app? Or perhaps you want to listen to a YouTube video on your mobile device faster than 1x.  Both of these are possible if YouTube videos could be added to a podcast.

I have created a web service that allows a user to simply enter a YouTube URL and the video is downloaded, converted to MP3, and then added to a podcast feed that can be subscribed to easily by any podcatcher.

Try the service here!

The service is written in PHP, but relies on ffmpeg for video conversion to audio.

The code is available on my GitHub here.

Feel free to get in touch with me about this project or contribute to its development on GitHub.

README

build status
coverage report

Description

Makes an RSS podcast feed from given YouTube, Vimeo, SoundCloud, and CRTV URLs. Also supports manually uploading audio
or video, setting the metadata, and uploading album art.

Get Started Immediately

To get started immediately, make an account https://ytpod.mikedombrowski.com, add content, and subscribe to the generated feed with your favorite podcast player.

Usage

Open your web browser to the server that you have set up. Make a new account using the sign up link on the home page. Copy in a YouTube video’s URL on the Add a Video page and click Add Video to Feed.

Subscribe to the generated feed using the URL shown on the Add a Video page to receive updates as they come.

Running Your Own Server

Configuration

Download this repository and then edit config.yml to add your Google API server key.
Set hostname to your public ip or domain and subdirectory.

  • Set database configuration, also in config.yml.
  • Install pug-php, symfony/yaml, and mongodb/mongodb (optional) using composer
  • Set batchProcess.php to run as often as you like using the Windows Task Sheduler or cron on linux. This script is used to delete files once they are kicked out of every user’s feed. If you have lots of disk space, then you may not want to run this script ever, so that the audio and thumbnails are always available.

Configuration With Evironment Variables

Instead of editing config.yml, you can choose to set the options through environment variables. For this to work PHP
must have environment variables enabled (check php.ini).

Set variables in the following format AD_<NAME OR GROUP NAME>_<NAME IF WITHIN GROUP>

Examples:

  • subdirectory = AD_SUBDIRECTORY
  • download-directory = AD_DOWNLOAD_DIRECTORY
  • api-keys: google = AD_API_KEYS_GOOGLE
  • database: connection-string = AD_DATABASE_CONNECTION_STRING

Updating

To update to the latest release on GitHub download or clone the repository to your computer.

  1. Move all files in the src directory to your current install location, overwrite all existing files except for config.yml
  2. Using the command line, run php config-update.php from your web root
  3. Edit config.yml to make sure that the settings are correct
  4. Load the site in your browser to force the database check/update and then you’re done

Documentation

PHP API documentation is available here.

Future Tasks

  • Join sessions if the same user is logged in on multiple computers. Possibly move sessions into DB, or just keep on filesystem since that’s working fine.
  • More statistics. Possibly a GitHub style punchcard.

Completed Tasks

  • Dynamically find all SupportedSites so that new ones can simply be placed in the correct folder and will not require other code changes
  • Moved configuration into yaml
  • Add Vimeo support
  • Easier updating using config-update.php
  • Enable choice between audio and video download
  • Add manual upload
  • Switch to Pug for HTML rendering
  • Add password reset
  • Add email verification
  • Add SoundCloud to supported sites
  • Audio player with playback speed control added to account page
  • Add CRTV to supported sites
  • Session files are now written to disk as soon as possible so that a single browser can have multiple pages open and downloading concurrently
  • Better session handling (session cookie is now stored for a long time and refreshed often)
  • Create and verify databases
  • Account management added
  • Customize feed options including Title, Author, image, etc.
  • Users can choose to keep their feeds private and secured by HTTP Basic Authentication (Requires podcatcher support)

Leave a Reply