Skip to main content

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

Project description

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 python 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:

https://user-images.githubusercontent.com/82916197/176830848-dc5e7068-13ff-4d13-a9d7-055258692628.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.

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

tube-cast-0.1.0.tar.gz (9.9 kB view hashes)

Uploaded Source

Built Distribution

tube_cast-0.1.0-py3-none-any.whl (10.0 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