Skip to content

abe-101/tube-cast

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tube-Cast

Cover image

A command-line tool that converts YouTube videos into Anchor FM podcasts.

Installation

Check out this blog post for a step-by-step guide on installing the tool on windows-11
How To Install Python 3 on Windows 11

pip install tube-cast

Usage

[user@ubuntu]$ tube-cast]$ tube-cast --help
Usage: tube-cast [OPTIONS] COMMAND [ARGS]...

  Convert YouTube video(s) to Anchor FM

Options:
  -d, --draft-mode      Save podcast as draft
  -t, --thumbnail_mode  Include YouTube thumbnail in podcast
  -u, --add-url         Add the YouTube URL To podcast description
  -x, --is-explicit     Mark podcast as explicit
  -h, --headless-mode
  --help                Show this message and exit.

Commands:
  youtube-channel       Takes in a YouTube Channel ID
  youtube-id            Takes in YouTube IDS as arguments
  youtube-id-from-file  Takes in a file containing youtube id (one per line)
  youtube-playlist      Takes in a YouTube Playlist ID

Environment Variables

tube-cast will prompt the user for their email and password to anchor.fm

[user@ubuntu]$ tube-cast youtube-id
Enter anchor.FM user email: 
Enter anchor.FM password: 

The prompt can be avoided by exporting them as environment variables:

export ANCHOR_EMAIL='YOUR ANCHOR FM EMAIL HERE'
export ANCHOR_PASSWORD='YOUR ANCHOR FM PASSWORD HERE'

Roadmap

  • add better test case
  • add better error catching
  • include podcast publish date
  • create documentation
  • Test tool in microsoft powershell
  • make available on pypi

Running it with Windows

Method 1: pip install
Assuming you have python and pip installed already, open Command Prompt or Windows Powershell
Run this command: pip install tube-cast Once the install is done you can simply run pip list to double check the package was installed run the command: cls to clear the command prompt/powershell
You should now be able to run tube-cast commands. To start run this command: tube-cast --help

Method 2: github download
Simply download and extract the github.
With the folder open you can right click any white-space in the "tube-cast-main" folder and open in terminal, run this command pip install .
with Command Prompt simply copy the "tube-cast-main" folder path > open CMD type in cd PastePath, you can now run this command pip install .

Note: Method 2 is good if you need to edit the program yourself. You'll simply edit the python files you need changed, follow the steps and instead of running pip install . Youll be doing pip install . --upgrade Doing so will update the package with your desired changes.

Contributors

Demo

Click here to view a video demo on YouTube, or watch below:

Tube.Cast.mp4

Contributing

  1. Fork it
  2. Create your feature branch git checkout -b my-new-feature
  3. Commit your changes git commit -am 'Add some feature'
  4. Push to the branch git push origin my-new-feature
  5. Create new Pull Request

Testing

To test your changes generate a distribution package To do so make sure you have the latest version of PyPA’s build installed:

python3 -m pip install --upgrade build

Now run this command from the projects root directory:

python3 -m build

This command should output a lot of text and once completed should generate two files in the dist directory:

dist/
  example_package_YOUR_USERNAME_HERE-0.0.1-py3-none-any.whl
  example_package_YOUR_USERNAME_HERE-0.0.1.tar.gz

Hop into a Virtual Environment:

python3 -m venv <DIR>
source <DIR>/bin/activate

Install the newly created package

pip install dist/tube-cast-<VERSION>.tar.gz

Known Issues

If you discover any bugs, feel free to create an issue on GitHub or create a fork and send a pull request.