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 details)

Uploaded Source

Built Distribution

tube_cast-0.1.0-py3-none-any.whl (10.0 kB view details)

Uploaded Python 3

File details

Details for the file tube-cast-0.1.0.tar.gz.

File metadata

  • Download URL: tube-cast-0.1.0.tar.gz
  • Upload date:
  • Size: 9.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.9.13

File hashes

Hashes for tube-cast-0.1.0.tar.gz
Algorithm Hash digest
SHA256 75c644e76435f59d6031b4bdcb752054f4a24529d51248a30c39dc65ecb6bf41
MD5 b4f606f62d01a3a0a908c5f7c6ba118f
BLAKE2b-256 96652fcdd9c0b6b346fbfaf663bc19a8244c03cb36c9db31a7fc920c112d4962

See more details on using hashes here.

File details

Details for the file tube_cast-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: tube_cast-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 10.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.9.13

File hashes

Hashes for tube_cast-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 945f9c09027447a778e8e2bcf73f62b0ef9c9d6f9967541ca0df579b98d40fb7
MD5 b165074d8e0e15f3f15cd79c658248d4
BLAKE2b-256 b95b5e57b513f3682fb065a5c5e387eb67f8f7987ec45f83f635040a685f3a02

See more details on using hashes here.

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