git404hub

what is pod-search fr?

ahloiscreamo/pod-search — explained in plain English

Analysis updated 2026-05-18

0ShellAudience · generalComplexity · 2/5LicenseSetup · easy

tl;dr

pod-search is a terminal script that helps you find a podcast by name or genre and copies its RSS feed link to your clipboard for use in another podcast app.

vibe map

mindmap
  root((pod-search))
    What it does
      Finds podcast RSS feeds
      Copies to clipboard
      fzf driven menu
    Tech stack
      Bash
      fzf
      curl
      jq
    Use cases
      Search by name
      Browse by genre
      Feed URL for terminal players
    APIs
      iTunes Search API
      Podcast Index API

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Quickly find a podcast's RSS feed URL by name and paste it into a terminal podcast player.

VIBE 2

Browse trending podcasts in a specific genre like Comedy or True Crime without leaving the terminal.

VIBE 3

Preview a show's description, episode count, and language before subscribing to its feed.

VIBE 4

Avoid hitting the Podcast Index API repeatedly by relying on its local caching of categories and trending lists.

what's the stack?

ShellBashfzfcurljq

how it stacks up fr

ahloiscreamo/pod-search123satyajeet123/bitnet-serveralexbloch-ia/legal-data
Stars000
LanguageShellShellShell
Setup difficultyeasyeasymoderate
Complexity2/52/52/5
Audiencegeneraldevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Genre browsing needs a free Podcast Index API key and secret, name search works with zero configuration.

MIT license: use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

in plain english

pod-search is a small terminal script for Linux that finds a podcast's RSS feed link and copies it straight to the clipboard, so it can be pasted into a terminal based podcast player. The author built it because many podcast clients only need a raw feed URL, and finding that link normally means opening a browser and digging through a podcast directory, which felt like an unnecessary detour for something otherwise done entirely from the terminal. When launched, the script presents a menu built with fzf offering two modes. Searching by name uses the iTunes Search API to look up podcasts by keyword, needs no account or API key, and lets the user pick a match from a list before copying its feed URL. Browsing by genre instead pulls a live list of categories from the Podcast Index API, shows the trending podcasts in whichever category is chosen, and displays a preview with the show's description, episode count, and language before a final pick is made. Genre browsing uses Podcast Index rather than Apple because Apple no longer offers a reliable way to see top podcasts by category, and Podcast Index also provides richer details for the preview. Using genre browsing requires signing up for a free Podcast Index API key and secret and saving them, along with a custom identifying name for the app, into a small configuration file. Keyword search works with no setup at all. The script depends on a handful of common command line tools such as curl, jq, and fzf, plus either wl-copy or xclip depending on whether the system uses Wayland or X11, and it automatically detects which clipboard tool to use. To avoid calling the API constantly, genre browsing caches the category list for 30 days and each genre's trending list for 24 hours, and it will ask whether to reuse a still fresh cache or force a refresh. The author is upfront that genre browsing only surfaces roughly the top 200 trending shows per category rather than every podcast in that genre, and that the tool deliberately skips terminal image previews in favor of plain text descriptions. pod-search is released under the MIT license.

prompts (copy fr)

prompt 1
Explain the difference between pod-search's name search mode and genre browse mode.
prompt 2
Walk me through setting up a Podcast Index API key so I can use genre browsing in pod-search.
prompt 3
What dependencies do I need installed on Linux to run pod-search?
prompt 4
How does pod-search's local caching work for genre trending lists?

Frequently asked questions

what is pod-search fr?

pod-search is a terminal script that helps you find a podcast by name or genre and copies its RSS feed link to your clipboard for use in another podcast app.

What language is pod-search written in?

Mainly Shell. The stack also includes Shell, Bash, fzf.

What license does pod-search use?

MIT license: use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

How hard is pod-search to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is pod-search for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.