tzeentch

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 9 Open GitHub ↗

A load-balancing redirector for privacy-oriented alternative frontends

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Tzeentch
A load-balancing redirector for [privacy-oriented alternative frontends](https://github.com/mendel5/alternative-front-ends). Inspired and partially rewritten from [Farside.link](https://github.com/benbusby/farside).

Demo instance at [https://alternator.hstn.me](https://alternator.hstn.me).

## About
**Tzeentch** maintains a list of links to [privacy-oriented alternative frontends](https://github.com/mendel5/alternative-front-ends), which scrape popular but horribly written websites and present them in a much cleaner, ad- and tracking-free way.

Alternative frontends can easily get rate-limited or banned if there is an unusual amount of traffic coming from them because too many users are on a single instance. In order to help distribute users more effectively, **Tzeentch** will randomly select an instance and forward the original request to it.

To use it, you will need to set up a redirector add-on for your browser such as [Redirector](https://addons.mozilla.org/en-US/firefox/addon/redirector/) or [Redirect Web for Safari](https://apps.apple.com/us/app/redirect-web-for-safari/id1571283503).

As an example, instead of redirecting `reddit.com` to a `libreddit` instance, you instead redirect it to `https://tzeentch-instance/?libreddit/r/subreddit`.

## Difference to LibRedirect
[LibRedirect](https://libredirect.github.io/) is a browser add-on that already does most of the work here without the need for another redirector add-on and a webservice like this. However, it does not work on mobile devices (there is [a hack for Android](https://mike.sg/2022/07/10/how-to-use-libredirect-on-android/), but none for iOS) and it has a fixed scope of redirects. In contrast, with **Tzeentch** you can create your own list of frontends and their respective list of instances as soon as you discover them, and simply add them directly to your favorite redirector add-on.

## Difference to Farside.link
[Farside.link](https://github.com/benbusby/farside) was the inspiration to create **Tzeentch**. The reason for this clone (instead of contributing to Farside) is twofold:
1. I do not know any Erlang/Elexir, the language Farside is written in.
2. I cannot install the dependencies of Farside on my VPS.

**Tzeentch** is written in PHP, which is universally available, and even free hosts with PHP support exist, making it much easier to deploy. You will only need to upload a single file `index.php` to run **Tzeentch** on a VPS, and an additional `data.json` if you want to maintain a local configuration for your own frontends and their instances.

## Configuration
Every alternative frontend and its instances are stored in a JSON configuration which **Tzeentch** refers to. The configuration is compatible with that of [LibRedirect](https://libredirect.github.io/).

**Tzeentch** will search for configurations in this order:
1. A local JSON file called `data.json`
2. [The latest commited configuration in the Tzeentch repository](https://github.com/thefranke/Tzeentch/blob/main/data.json)
2. [The latest commited configuration of LibRedirect](https://github.com/libredirect/instances/blob/main/data.json)
3. [The latest commited configuration of Farside](https://github.com/benbusby/farside/blob/main/services-full.json)

If you want to add a new or custom frontend, fetch a copy of `data.json` from this repository and simply add the frontend in question as follows:

```
"alternative-frontend-name": {
    "clearnet": [
      "url1",
      "url2"
    ],
    "tor": [ ... ],
    "i2p": [ ... ],
    "loki": [ ... ]
  }
```

tzeentch

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README