Observed since 20 Oct, 20:55 UTC
No superseded metadata states collected. Unchanged observations do not create new revisions.
aetherpod
Terminal Podcast Manager — subscribe, browse, and play podcasts from your terminal
╔══════════════════════════════╗ ║ A E T H E R P O D ║ ║ Terminal Podcast Manager ║ ╚══════════════════════════════╝
Terminal Podcast Manager
Subscribe, browse, and play podcasts — all from your terminal.
BTW.. I use Arch


s) and inline name filter (f)1–4. mpv only: EQ requires mpv's lavfi audio filter bridge, so it works on Linux/macOS (mpv) but is unavailable on Windows (which uses VLC).aetherpod -u to upgrade)No Python or pip needed. Grab the binary for your platform from the Releases page (or the latest Actions build artifacts):
Prefer a package manager?
pip install aetherpod(PyPI) works on Linux, macOS, and Windows.
| Platform | Download |
|---|---|
| Windows (x86_64) | aetherpod-windows.exe |
| Linux (x86_64) | aetherpod-linux |
| macOS (Apple Silicon) | aetherpod-macos-arm64 |
| macOS (Intel) | aetherpod-macos-x86_64 |
The binaries are unsigned, so Windows SmartScreen and macOS Gatekeeper may warn on first run. Windows: click More info → Run anyway. macOS:
xattr -d com.apple.quarantine aetherpod-macos.
Windows: VLC is detected automatically even when not on PATH (installed under
Program Filesor the registry). AetherPod uses VLC on Windows since mpv's control channel is Linux/macOS-only.macOS: VLC.app and Homebrew are detected even when not on PATH (
/Applications/VLC.app/Contents/MacOS/vlc,/opt/homebrew,/usr/local). mpv is preferred when present.EQ on Windows: the audio EQ presets (
1–4) require mpv and are therefore not available on Windows (VLC is used there). mpv-on-Windows support is on the roadmap.
# Install mpv (Arch)
sudo pacman -S mpv
# Install mpv (Debian/Ubuntu)
sudo apt install mpv
# Install mpv (macOS)
brew install mpv
AetherPod is on PyPI and published to GitHub Releases on every version tag.
Option 1 — pip / pipx (recommended, all platforms):
pipx install aetherpod # isolated env + on PATH (best for a CLI/TUI)
# or
pip install --user aetherpod
Option 2 — Interactive installer (from source):
git clone https://github.com/AetherSolDev/AetherPod.git
cd AetherPod
bash scripts/install.sh
Option 3 — Makefile:
make install # system-wide
make install-user # user-local, no root
Option 4 — Manual venv:
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
pip install -e .
scripts/install.sh walks you through system-wide, user-local, or venv installation.
aetherpod # Launch TUI
aetherpod --help # CLI usage
aetherpod list # List subscribed feeds
--start). If the episode restarts from the beginning, the CDN is rejecting the seek — this is a host limitation, not a bug. Downloading the episode would allow reliable resume.AetherPod checks GitHub for a newer version on startup and shows a notification when one is available.
aetherpod -u # Upgrade to the latest version
pip install --upgrade aetherpod (or pipx upgrade aetherpod). aetherpod -u also works for editable/git installs.-u requires pip/git and will not work inside a bundled executable).| Key | Action |
|---|---|
a | Add feed |
s | Sort feeds (subscribe order → A-Z → Z-A) |
f | Filter feeds by name |
Enter | Browse episodes / Play |
Space | Pause / Resume |
s | Stop (Episode screen) |
[ / ] | Speed down / up |
← / → | Seek -30s / +30s |
1 / 2 / 3 / 4 | EQ presets: Off / Bright / Warm / Balanced (mpv only) |
f | Toggle unplayed filter (Episode screen) |
a | Add to play queue |
v | View play queue |
/ | Search across all feeds |
d | Episode details |
N | Now-playing screen |
t | Toggle theme |
q | Quit |
? | Help |
| Data | Location |
|---|---|
| State | ~/.local/state/aetherpod/state.json |
| EQ presets (user-editable) | ~/.config/aetherpod/eq.json |
| Logs | ~/.local/state/aetherpod/log/aetherpod.log |
Override state path with --data /custom/path.json (supports relative paths for USB portability).
GPLv3 — Free as in freedom.
Download counts and popularity will appear here as the collector receives them.
| Package / target | Requirement | Relationship |
|---|---|---|
feedparserEnvironment{
"extras": "",
"marker": null,
"requires_python": ">=3.9",
"evaluation": "NOT_EVALUATED"
} | feedparser<7.0,>=6.0 | runtime |
textualEnvironment{
"extras": "",
"marker": null,
"requires_python": ">=3.9",
"evaluation": "NOT_EVALUATED"
} | textual<2.0,>=0.41 | runtime |
aiohttpEnvironment{
"extras": "",
"marker": null,
"requires_python": ">=3.9",
"evaluation": "NOT_EVALUATED"
} | aiohttp<4.0,>=3.9 | runtime |
bdist_wheel · 80.01 KB · Python py3
sdist · 84.15 KB · Python source
Observed since 20 Oct, 20:55 UTC
No superseded metadata states collected. Unchanged observations do not create new revisions.
package_version:5519e815a3f3ebf43bd7bb7bfeac3feb8db9c8b9e9c3707de6520e336ba9e450