@soundporn/cli
v0.1.1
Published
Command-line client for the sound.porn meme soundboard — search, list, and download sounds.
Maintainers
Readme
@soundporn/cli
Command-line client for the sound.porn meme soundboard. Search, browse, and download sounds from your terminal.
Install
npm install -g @soundporn/cli # installs the `soundporn` command
# or run without installing:
npx @soundporn/cli search "vine boom"Usage
soundporn play boom # exact slug → plays instantly
soundporn play "vine boom" # no exact match → pick from top 10 (↑/↓, Enter)
soundporn search "vine boom" # search by keyword
soundporn list --category Memes --sort popular
soundporn get vine-boom # full details for a sound
soundporn download vine-boom --out ./boom.mp3
soundporn open vine-boom # open the sound page in your browser
soundporn categories # list categories with countsOptions
| Flag | Description |
|------|-------------|
| --limit <n> | Max results (search/list) |
| --category <name> | Filter list by category |
| --sort <order> | recent | name | popular | halloffame | random |
| --page <n> | Page number for list |
| --out <path> | Output path for download |
| --json | Output raw JSON (great for scripting) |
| --api <url> | Point at a different API base (or set SOUNDPORN_API) |
Playback
play uses a system audio player: afplay on macOS (built in), and on Linux one of
mpg123, ffplay, mpv, cvlc, play (sox), or paplay — install one if none is present.
Scripting
Every command supports --json:
soundporn search rizz --json | jq '.data[].slug'License
MIT
