Skip to main content
Join the official Python Developers Survey 2018 and win valuable prizes: Start the survey!

Command line podcast client

Project description

castero

GitHub release Build Status codecov

castero is a podcast client for the command line.

example client screenshot

Installation

Install from PyPi with pip:

$ pip install castero

Upgrading:

$ pip install castero --upgrade

Manual Installation

$ git clone https://github.com/xgi/castero
$ cd castero
$ sudo python setup.py install

Dependencies

Running castero requires the following external dependencies:

  • vlc >= 2.2.3

Usage

After installing castero, it can be run with simply:

$ castero

The help menu provides a list of controls and can be accessed by pressing h. Alternatively, see the list below:

Commands
    h            - show this help screen
    q            - exit the client
    a            - add a feed
    d            - delete the selected feed
    r            - reload/refresh feeds
    s            - save episode for offline playback
    arrows       - navigate menus
    page up/down - scroll menus
    enter        - play selected feed/episode
    space        - add selected feed/episode to queue
    c            - clear the queue
    n            - go to the next episode in the queue
    i            - invert the order of the menu
    p or k       - pause/play the current episode
    f or l       - seek forward
    b or j       - seek backward

Configuration

The configuration file is located at {HOME}/.config/castero/ after the client has been run at least once.

Please see castero.conf for a list of available settings.

Additionally, a file containing your list of feeds is located at {HOME}/.local/share/castero/feeds. This file is provided to avoid redownloading feeds on every startup. However, it is not intended to be manually modified. Removing this file will simply cause castero to replace it with an empty list next time you run the client.

Testing

This project uses pytest for testing. To run tests, run the following command in the project's root directory:

$ python -m pytest tests

You can also run tests for an individual unit, i.e.:

$ python -m pytest tests/test_feed.py

License

MIT License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
castero-0.3.1-py3-none-any.whl (35.7 kB) Copy SHA256 hash SHA256 Wheel py3 Sep 15, 2018
castero-0.3.1.tar.gz (28.9 kB) Copy SHA256 hash SHA256 Source None Sep 15, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page