https://github.com/worldwidemisery/pycamp
a command-line tool to fetch a random bandcamp album from a chosen genre - instantly.
https://github.com/worldwidemisery/pycamp
audio automation bandcamp browser-automation cli command-line-tool music music-discovery music-discovery-tool playwright playwright-python python random terminal web-scraper
Last synced: 6 days ago
JSON representation
a command-line tool to fetch a random bandcamp album from a chosen genre - instantly.
- Host: GitHub
- URL: https://github.com/worldwidemisery/pycamp
- Owner: worldwidemisery
- License: mit
- Created: 2025-06-04T17:02:57.000Z (17 days ago)
- Default Branch: main
- Last Pushed: 2025-06-05T01:29:17.000Z (16 days ago)
- Last Synced: 2025-06-08T15:24:33.604Z (13 days ago)
- Topics: audio, automation, bandcamp, browser-automation, cli, command-line-tool, music, music-discovery, music-discovery-tool, playwright, playwright-python, python, random, terminal, web-scraper
- Language: Python
- Homepage:
- Size: 113 KB
- Stars: 35
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
a command-line tool to fetch a random bandcamp album from a chosen genre — instantly.
## features
- open random bandcamp albums by tag/genre
- two modes:
- `quick`: quick, no album details, just opens it
- `full`: fetch album details (title, artist, date, tags) before prompting to open
- works with any genre tag on bandcamp
- supports short flags for fast access (`-q`, `-f`)
## installation
```bash
pip install pycamp-cli
```
## usage
```
pycamp [ --quick | -q | --full | -f ]
```
### examples
```bash
pycamp hardcore
pycamp ambient --full
pycamp blackened crust -q
```
if no flag is provided, `--quick` is the default.
## flags
| flag | mode description |
|--------------|------------------------------------------|
| `--quick` or `-q` | quick mode — skips detail fetch, just opens |
| `--full` or `-f` | full mode — shows album info before prompting |
## notes
- uses playwright under the hood. on first run, you may need to install browser dependencies:
```bash
playwright install
```
- make sure `node` and a recent python (3.7+) are installed.
## tip
use specific genres like:
- `trip hop`
- `blackened crust`
- `powerviolence`
- `spiritual jazz`
- `grindcore`
they map directly to bandcamp tag pages.
## license
MIT © jasper binetti-makin
[](https://pypi.org/project/pycamp-cli/)
[](https://github.com/worldwidemisery/pycamp-cli)