README
¶
dumb
With the massive daily increase of useless scripts on Genius's web frontend, and having to download megabytes of clutter, dumb tries to make reading lyrics from Genius a pleasant experience, and as lightweight as possible.
Installation & Usage
Docker
docker run -p 8080:5555 --name dumb ghcr.io/rramiachraf/dumb:latest
Build from source
Go 1.24+ is required.
git clone https://github.com/rramiachraf/dumb
cd dumb
make build
./dumb
Notes:
- The default port is 5555, you can use other ports by setting the
PORTenvironment variable. - Genius servers are behind a Cloudflare reverse proxy, which means certain IPs won't be able to send requests, to partially mitigate this, you can specify a proxy by setting the
PROXYvariable (must be a valid URI).
Public Instances
| URL | Tor | I2P | Region | CDN? | Operator |
|---|---|---|---|---|---|
| https://dumb.ducks.party | No | No | NL | No | https://ducks.party |
| https://dumb.privacydev.net | Yes | No | FR | No | https://privacydev.net |
| https://dumb.hyperreal.coffee | No | No | US | No | https://hyperreal.coffee |
| https://dm.vern.cc | Yes | Yes | US | No | https://vern.cc |
| https://dumb.lunar.icu | No | No | DE | Yes | @MaximilianGT500 |
| https://dumb.privacyfucking.rocks | No | No | DE | - | https://privacyfucking.rocks |
| https://sing.whatever.social | No | No | US/DE | Yes | Whatever Social |
| https://dumb.bloat.cat | No | No | DE | No | https://bloat.cat |
| https://dumb.jeikobu.net | No | No | DE | Yes | https://jeikobu.net |
| https://dumb.canine.tools | No | No | US | No | https://canine.tools |
| https://lyr.dc09.ru | No | No | RU | No | @DarkCat09 |
| https://db.kuuro.net | Yes | No | US | No | https://kuuro.net/ |
| https://genius.fsky.io | Yes | No | PL | No | https://fsky.io/ |
| https://dumb.artemislena.eu | Yes | No | DE | No | https://artemislena.eu |
Notes:
- Instances list in JSON format can be found in instances.json file.
- For people who might be capable and interested in hosting a public instance feel free to do so, and don't forget to open a pull request, so your instance can be included here.
Contributing
Contributions are welcome.
License
Documentation
¶
There is no documentation for this package.
Source Files
Directories
Click to show internal directories.
Click to hide internal directories.