https://github.com/lamasters/termcast
A terminal-based podcast player that syncs between devices
https://github.com/lamasters/termcast
git podcasts terminal terminal-based tui
Last synced: about 2 months ago
JSON representation
A terminal-based podcast player that syncs between devices
- Host: GitHub
- URL: https://github.com/lamasters/termcast
- Owner: lamasters
- Created: 2022-04-29T16:55:43.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2022-05-20T19:25:08.000Z (about 4 years ago)
- Last Synced: 2025-11-12T01:03:01.416Z (7 months ago)
- Topics: git, podcasts, terminal, terminal-based, tui
- Language: Python
- Homepage:
- Size: 25.4 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# TermCast
A terminal-based podcast player that syncs between devices
## Installation
This requires VLC Media Player to be installed
On linux
`sudo snap install vlc`
or
`sudo apt install vlc`
On Mac
`brew install vlc`
Or download from [here](https://www.videolan.org/vlc/)
Dependencies are mangaged with poetry. Installation instructions are [here](https://python-poetry.org/docs/)
Dependencies can be installed by running
`poetry install`
## Usage
### Local sources
Create a local folder in the TermCast root called `termcast_sources`. This folder should contain the files `sources.json` and `listen_time.json`. An example file for each of these is included. `example_listen_time.json` can be copied directly into the folder as is. `example_sources.json` can be edited with your list of RSS feeds and then copied into the folder. Make sure to rename these to `sources.json` and `listen_time.json`. In the file `config.json` change `source_type` to `"local"` instead of `"git"`.
### Synced sources
Create a personal git repository called `termcast_sources`. Clone this repository into the TermCast root. Follow the instructions above and commit the files to your repository. Leave the `source_type` as `"git"` in `config.json`. If you change your sources, push the changes to the repository. At launch, TermCast will download the latest source list and listen times. When finished listening, changes to listen times will be pushed to the repository.
The player can be run with
`poetry run python main.py`
The player can be navigated by either keyboard or mouse.
On keyboard, the arrow keys can be used to navigate within a widget and tab will switch between widgets.