https://github.com/abe-101/tube-cast
A command-line tool that converts YouTube videos into Anchor FM podcasts
https://github.com/abe-101/tube-cast
anchor-fm podcast python video youtube
Last synced: about 1 year ago
JSON representation
A command-line tool that converts YouTube videos into Anchor FM podcasts
- Host: GitHub
- URL: https://github.com/abe-101/tube-cast
- Owner: abe-101
- License: mit
- Created: 2022-06-16T13:10:31.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2022-08-25T17:40:16.000Z (almost 4 years ago)
- Last Synced: 2025-03-21T05:47:48.098Z (about 1 year ago)
- Topics: anchor-fm, podcast, python, video, youtube
- Language: Python
- Homepage: https://pypi.org/project/tube-cast/
- Size: 536 KB
- Stars: 13
- Watchers: 1
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Tube-Cast
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](https://habet.dev//blog/how-to-install-python-3-on-windows-11/)
```
pip install tube-cast
```
## Usage
```bash
[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
```bash
[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:
```bash
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
[](https://github.com/abe-101)
* [Abe](https:github.com/abe-101)
* [Vraelot](https://github.com/Vraelot)
## Demo
[Click here](https://youtu.be/HBk-0wRGqHY "Tube-Cast Video Demo - YouTube") 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
source /bin/activate
```
Install the newly created package
```
pip install dist/tube-cast-.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.