Home

Awesome

Contributors Forks Stargazers Issues Docker Pulls AGPLv3 License

<!-- PROJECT LOGO --> <br /> <div align="center"> <h1>Intellectual</h1> <p> Alternate frontend for <a href="https://genius.com/">Genius</a> focused on privacy and simplicity <br /> <br /> <a href="https://github.com/Insprill/intellectual/issues">Report Bug</a> ยท <a href="https://github.com/Insprill/intellectual/issues">Request Feature</a> </p> </div> <!-- TABLE OF CONTENTS --> <details> <summary>Table of Contents</summary> <ol> <li><a href="#about-the-project">About The Project</a></li> <li><a href="#instances">Instances</a></li> <li><a href="#deployment">Deployment</a></li> <li><a href="#roadmap">Roadmap</a></li> <li><a href="#license">License</a></li> </ol> </details> <!-- ABOUT THE PROJECT -->

About The Project

Intellectual is an alternative frontend for Genius 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 for what features will be coming next!

<!-- Instances -->

Instances

Want your own instance listed here? Open an issue for it!
Not sure how to host your own instance? View the deployment instructions.

URLTorI2PCountryCloudflare
https://intellectual.insprill.net/NoNo๐Ÿ‡บ๐Ÿ‡ธ USโœ”๏ธ
https://intellectual.catsarch.com/YesYes๐Ÿ‡บ๐Ÿ‡ธ US
https://intellectual.frontendfriendly.xyz/NoNo๐Ÿ‡บ๐Ÿ‡ธ US
https://intellectual.lumaeris.com/NoNo๐Ÿ‡บ๐Ÿ‡ธ US
https://in.bloat.cat/NoNo๐Ÿ‡ท๐Ÿ‡ด RO
https://in2.bloat.cat/NoNo๐Ÿ‡ฉ๐Ÿ‡ช DE
https://intellectual.ducks.party/YesNo๐Ÿ‡ฉ๐Ÿ‡ช DE
https://intellectual.bunk.lol/NoNo๐Ÿ‡ฎ๐Ÿ‡ธ IS

If there is a checkmark under "Cloudflare", that means the site is proxied behind Cloudflare.
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 file.

<!-- DEPLOYMENT -->

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)

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

docker compose up -d

Native

If you don't want to use Docker, you can download the latest stable or nightly 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. To enable TLS, provide the --tls flag, followed by --tls-key-file and --tls-cert-file pointing to their respective files on disk.

<!-- ROADMAP -->

Roadmap

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 guide to get up-to-speed.

<!-- LICENSE -->

License

Distributed under the GNU Affero General Public License v3.0.
See LICENSE for more information.

<!-- MARKDOWN LINKS & IMAGES --> <!-- https://www.markdownguide.org/basic-syntax/#reference-style-links -->