Skip to content

csiew/Podzol

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Podzol

Another podcast app?! Yeah, I sometimes just want a podcast app that's barebones in both its feature-set and in storage use (that means streaming only, no downloading of MP3 files... for now).

Podzol is written in Python and uses JSON as a 'medium of storage' rather than a database (e.g. SQLite). The CLI client uses pygame for audio playback functionality, and uses a class written by sloth (sic) to handle audio streaming.

Getting Started

To build and run Podzol locally, follow these steps:

  1. Clone the repository and run pip install -r requirements.txt to install all dependencies.
  2. Run python src/PodzolShell.py or sh podzol.sh or ./podzol.

User Guide

Podzol is navigable through a rudimentary CLI interface. This requires you to use the commands listed below. The selection of a podcast or episode requires you to use flags (-f [number] for the podcast; -e [number] for the episode). You can refer to the numbers needed to select a podcast or episode using the list.

Commands

  • help: Shows a list of commands
  • search [keywords]: Search for podcasts or episodes (doesn't do much at the moment... to be fixed)
  • list -f: List all podcasts
  • list -f [key1]: List all episodes of a podcast
  • list -f [key1] -e [key2]: Display info about a specific episode
  • play -f [key1] -e [key2]: Play a podcast episode
  • delete -f [key1]: Remove a podcast from your library
  • reload: Reload the data from the JSON indexes
  • exit: Exit Podzol

Known issues

  • Playback doesn't start until after the entire MP3 is cached.
  • Sometimes the audio plays at a deafening loud high-speed.
  • Sometimes the audio plays in extreme slow motion.

Future changes

  1. Podzol will store its JSON files in ~/.local/share/ in Linux and macOS.
  2. Explore Ncurses to replace the shell-like interface (akin to Castero).
  3. Use backend for more sophisticated frontend clients like GNOME/GTK or even a SwiftUI Mac app.

About

A minimalist CLI podcast client

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors