Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Insprill/intellectual
Alternate frontend for Genius focused on privacy and simplicity
https://github.com/Insprill/intellectual
alternative alternative-frontends front-end genius hacktoberfest libre lyrics privacy rust self-hosted
Last synced: about 2 months ago
JSON representation
Alternate frontend for Genius focused on privacy and simplicity
- Host: GitHub
- URL: https://github.com/Insprill/intellectual
- Owner: Insprill
- License: agpl-3.0
- Created: 2022-09-14T04:58:56.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2024-08-20T15:28:43.000Z (4 months ago)
- Last Synced: 2024-10-11T03:21:41.147Z (2 months ago)
- Topics: alternative, alternative-frontends, front-end, genius, hacktoberfest, libre, lyrics, privacy, rust, self-hosted
- Language: Rust
- Homepage: https://intellectual.insprill.net/
- Size: 1.66 MB
- Stars: 32
- Watchers: 3
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-privacy-front-ends - Intellectual - Alternate front-end for Genius focused on privacy and simplicity. `Rust/AGPL-3.0`. (List / Genius)
- project-awesome - Insprill/intellectual - Alternate frontend for Genius focused on privacy and simplicity (Rust)
README
[![Contributors][contributors-shield]][contributors-url]
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![Issues][issues-shield]][issues-url]
[![Docker Pulls][docker-pulls-shield]][docker-pulls-url]
[![AGPLv3 License][license-shield]][license-url]
Intellectual
Alternate frontend for Genius focused on privacy and simplicity
Report Bug
·
Request Feature
Table of Contents
## About The Project
Intellectual is an alternative frontend for [Genius](https://genius.com/) focused on privacy and simplicity.
Written in Rust, Intellectual is incredibly lightweight.
Not requiring JavaScript and proxying all requests through the server, including images.
Intellectual is still very early in development and is lacking many features.
Check out the [roadmap](#roadmap) for what features will be coming next!
## Instances
Want your own instance listed here? Open an issue for it!
Not sure how to host your own instance? View the [deployment](#deployment) instructions.
| URL | Tor | I2P | Country | Cloudflare |
|--------------------------------------------|-------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|-----------|------------|
| https://intellectual.insprill.net/ | No | No | 🇺🇸 US | ✔️ |
| https://intellectual.catsarch.com/ | [Yes](http://intellectual.catsarchywsyuss6jdxlypsw5dc7owd5u5tr6bujxb7o6xw2hipqehyd.onion) | [Yes](http://ahysxi4w2wl7vf7ghy3hbqibvdg4e7je3s2lrsrb6xpukklevrka.b32.i2p) | 🇺🇸 US | |
| https://intellectual.frontendfriendly.xyz/ | No | No | 🇺🇸 US | |
| https://intellectual.lumaeris.com/ | No | No | 🇺🇸 US | |
| https://in.bloat.cat/ | No | No | 🇷🇴 RO | |
| https://in2.bloat.cat/ | No | No | 🇩🇪 DE | |
| https://intellectual.ducks.party/ | [Yes](http://pgsivdkc7p5qyxp7leorxk32mkomepxsmrqhpzqqi2zf2nc6urzodfad.onion) | No | 🇩🇪 DE | |
| https://intellectual.bunk.lol/ | No | No | 🇮🇸 IS | |
If there is a checkmark under "Cloudflare", that means the site
is proxied behind [Cloudflare](https://www.cloudflare.com/).
This means they have the ability to monitor traffic between you and the server.
The instances list in JSON format can be found in the [instances.json](instances.json) file.
## Deployment
### Deploying
#### Docker
The easiest way to host intellectual is via Docker, and the included Docker Compose file.
To create a new directory, download the `docker-compose.yml`, and cd into the directory, run the following command (Requires cURL 7.10.3 or newer)
```bash
curl https://raw.githubusercontent.com/Insprill/intellectual/master/docker-compose.yml --create-dirs -o intellectual/docker-compose.yml && cd intellectual
```
By default, it'll bind to `127.0.0.1:8080`.
Once you're satisfied with the container, you can start it with
```bash
docker compose up -d
```
#### Native
If you don't want to use Docker, you can download the latest [stable](https://github.com/Insprill/intellectual/releases) or [nightly](https://nightly.link/Insprill/intellectual/workflows/rust/master) build from GitHub actions. Make sure to choose the version for your target operating system.
Append the `-h` flag when running to see all available arguments.
### TLS
Intellectual supports TLS connections natively using [rustls][rustls-repo].
To enable TLS, provide the `--tls` flag, followed by `--tls-key-file` and `--tls-cert-file` pointing to their respective files on disk.
## Roadmap
- [x] Search for songs
- [x] View lyrics
- [x] More song info on the lryics page
- Song name
- Song/album image
- Album name
- Artist
- Release date
- [x] View artist info
- [x] Paginated searches
- [x] More robust error handling
- [x] Show artists' work on their page
- [x] Improve responsiveness
- [x] View Albums
- [x] Theme support
- [ ] Annotation support
- [ ] More search types
- By lyrics
- For artists
- For albums
- [ ] Better accessibility
- [ ] Support for more lyric sources
Contributions are what make the open-source community such an amazing place to learn, inspire, and create.
Any contributions you make are **greatly appreciated**!
If you're new to contributing to open-source projects,
you can follow [this](https://docs.github.com/en/get-started/quickstart/contributing-to-projects) guide to get up-to-speed.
## License
Distributed under the GNU Affero General Public License v3.0.
See [LICENSE][license-url] for more information.
[contributors-shield]: https://img.shields.io/github/contributors/Insprill/intellectual.svg?style=for-the-badge
[contributors-url]: https://github.com/Insprill/intellectual/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/Insprill/intellectual.svg?style=for-the-badge
[forks-url]: https://github.com/Insprill/intellectual/network/members
[stars-shield]: https://img.shields.io/github/stars/Insprill/intellectual.svg?style=for-the-badge
[stars-url]: https://github.com/Insprill/intellectual/stargazers
[issues-shield]: https://img.shields.io/github/issues/Insprill/intellectual.svg?style=for-the-badge
[issues-url]: https://github.com/Insprill/intellectual/issues
[license-shield]: https://img.shields.io/github/license/Insprill/intellectual.svg?style=for-the-badge
[license-url]: https://github.com/Insprill/intellectual/blob/master/LICENSE
[docker-pulls-shield]: https://img.shields.io/docker/pulls/insprill/intellectual?style=for-the-badge
[docker-pulls-url]: https://hub.docker.com/r/insprill/intellectual
[rustls-repo]: https://github.com/rustls/rustls