2019-06-21 01:17:21 +00:00
|
|
|
# Nitter (WIP)
|
|
|
|
|
2019-10-19 10:29:13 +00:00
|
|
|
[![Build Status](https://travis-ci.org/zedeus/nitter.svg?branch=master)](https://travis-ci.org/zedeus/nitter)
|
|
|
|
|
2019-06-21 01:17:21 +00:00
|
|
|
A free and open source alternative Twitter front-end focused on privacy. \
|
|
|
|
Inspired by the [invidio.us](https://github.com/omarroth/invidious) project.
|
|
|
|
|
|
|
|
- No JavaScript or ads
|
|
|
|
- All requests go through the backend, client never talks to Twitter
|
|
|
|
- Prevents Twitter from tracking your IP or JavaScript fingerprint
|
|
|
|
- Unofficial API (no rate limits or developer account required)
|
2019-12-25 02:28:05 +00:00
|
|
|
- Lightweight (for [@nim_lang](https://nitter.net/nim_lang), 36KB vs 580KB from twitter.com)
|
|
|
|
- RSS feeds
|
2019-10-23 10:16:21 +00:00
|
|
|
- Themes
|
2019-10-21 04:17:08 +00:00
|
|
|
- Mobile support (responsive design)
|
2019-12-25 02:28:05 +00:00
|
|
|
- AGPLv3 licensed, no proprietary instances permitted
|
2019-06-21 01:17:21 +00:00
|
|
|
|
2019-09-23 23:16:24 +00:00
|
|
|
## Todo (roughly in this order)
|
|
|
|
|
|
|
|
- Embeds
|
2019-12-25 02:28:05 +00:00
|
|
|
- Caching + archiving tweets/profiles
|
2019-09-23 23:16:24 +00:00
|
|
|
- Simple account system with customizable feed
|
|
|
|
- Json API endpoints
|
|
|
|
- Emoji support (WIP, uses native font for now)
|
|
|
|
|
|
|
|
## Resources
|
|
|
|
|
|
|
|
The wiki contains a list of
|
2019-09-24 01:48:17 +00:00
|
|
|
[Nitter instances](https://github.com/zedeus/nitter/wiki/Instances) and
|
2019-09-23 23:16:24 +00:00
|
|
|
a list of [browser extensions](https://github.com/zedeus/nitter/wiki/Extensions)
|
|
|
|
maintained by the community.
|
|
|
|
|
|
|
|
## Why?
|
|
|
|
|
|
|
|
It's basically impossible to use Twitter without JavaScript enabled. If you try,
|
|
|
|
you're redirected to the legacy mobile version which is awful both functionally
|
|
|
|
and aesthetically. For privacy-minded folks, preventing JavaScript analytics and
|
|
|
|
potential IP-based tracking is important, but apart from using the legacy mobile
|
|
|
|
version and a VPN, it's impossible.
|
|
|
|
|
|
|
|
Using an instance of Nitter (hosted on a VPS for example), you can browse
|
|
|
|
Twitter without JavaScript while retaining your privacy. In addition to
|
|
|
|
respecting your privacy, Nitter is on average around 15 times lighter than
|
|
|
|
Twitter, and in some cases serves pages faster.
|
|
|
|
|
|
|
|
In the future a simple account system will be added that lets you follow Twitter
|
|
|
|
users, allowing you to have a clean chronological timeline without needing a
|
|
|
|
Twitter account.
|
|
|
|
|
|
|
|
## Screenshot
|
|
|
|
|
|
|
|
![nitter](/screenshot.png)
|
|
|
|
|
2019-06-21 01:17:21 +00:00
|
|
|
## Installation
|
2019-06-23 23:34:30 +00:00
|
|
|
|
2019-10-21 03:19:00 +00:00
|
|
|
To compile Nitter you need a Nim installation, see
|
|
|
|
[nim-lang.org](https://nim-lang.org/install.html) for details. It is possible to
|
|
|
|
install it system-wide or in the user directory you create below.
|
2019-09-13 09:23:21 +00:00
|
|
|
|
2019-10-21 03:19:00 +00:00
|
|
|
You also need to install `libsass` to compile the scss files. On Ubuntu and
|
|
|
|
Debian, you can use `libsass-dev`.
|
2019-08-08 16:34:49 +00:00
|
|
|
|
2019-06-21 01:17:21 +00:00
|
|
|
```bash
|
2019-08-08 16:34:49 +00:00
|
|
|
# useradd -m nitter
|
|
|
|
# su nitter
|
|
|
|
$ git clone https://github.com/zedeus/nitter
|
|
|
|
$ cd nitter
|
2019-10-21 03:19:00 +00:00
|
|
|
$ nimble build -d:release
|
2019-09-13 09:03:53 +00:00
|
|
|
$ nimble scss
|
2019-08-08 16:34:49 +00:00
|
|
|
$ mkdir ./tmp
|
2019-06-21 01:17:21 +00:00
|
|
|
```
|
|
|
|
|
2019-10-23 22:17:38 +00:00
|
|
|
Set your hostname, port, page title and HMAC key in `nitter.conf`, then run
|
|
|
|
Nitter by executing `./nitter`. You should run Nitter behind a reverse proxy
|
|
|
|
such as [Nginx](https://github.com/zedeus/nitter/wiki/Nginx) or Apache for
|
|
|
|
better security.
|
2019-06-21 01:17:21 +00:00
|
|
|
|
2019-10-17 22:10:40 +00:00
|
|
|
To build and run Nitter in Docker:
|
|
|
|
```bash
|
2019-10-21 04:17:08 +00:00
|
|
|
docker build -t nitter:latest .
|
|
|
|
docker run -v $(pwd)/nitter.conf:/src/nitter.conf -d -p 8080:8080 nitter:latest
|
|
|
|
```
|
|
|
|
|
|
|
|
A prebuilt Docker image is provided as well:
|
|
|
|
```bash
|
|
|
|
docker run -v $(pwd)/nitter.conf:/src/nitter.conf -d -p 8080:8080 zedeus/nitter:latest
|
2019-10-17 22:10:40 +00:00
|
|
|
```
|
|
|
|
|
2019-09-13 09:03:53 +00:00
|
|
|
To run Nitter via systemd you can use this service file:
|
2019-08-08 16:34:49 +00:00
|
|
|
|
|
|
|
```bash
|
|
|
|
[Unit]
|
|
|
|
Description=Nitter (An alternative Twitter front-end)
|
|
|
|
After=syslog.target
|
|
|
|
After=network.target
|
|
|
|
|
|
|
|
[Service]
|
|
|
|
Type=simple
|
|
|
|
|
|
|
|
# set user and group
|
|
|
|
User=nitter
|
|
|
|
Group=nitter
|
|
|
|
|
|
|
|
# configure location
|
|
|
|
WorkingDirectory=/home/nitter/nitter
|
|
|
|
ExecStart=/home/nitter/nitter/nitter
|
|
|
|
|
|
|
|
Restart=always
|
|
|
|
RestartSec=15
|
|
|
|
|
|
|
|
[Install]
|
|
|
|
WantedBy=multi-user.target
|
|
|
|
```
|
|
|
|
|
2019-09-13 09:03:53 +00:00
|
|
|
Then enable and run the service:
|
2019-08-08 16:34:49 +00:00
|
|
|
`systemctl enable --now nitter.service`
|
|
|
|
|
2019-12-25 02:28:05 +00:00
|
|
|
## Donating <a href="https://liberapay.com/zedeus/donate"><img alt="Donate using Liberapay" src="https://liberapay.com/assets/widgets/donate.svg"></a>
|
|
|
|
|
|
|
|
BTC: bc1qp7q4qz0fgfvftm5hwz3vy284nue6jedt44kxya \
|
|
|
|
ETH: 0x66d84bc3fd031b62857ad18c62f1ba072b011925 \
|
|
|
|
LTC: ltc1qhsz5nxw6jw9rdtw9qssjeq2h8hqk2f85rdgpkr \
|
|
|
|
XMR: 42hKayRoEAw4D6G6t8mQHPJHQcXqofjFuVfavqKeNMNUZfeJLJAcNU19i1bGdDvcdN6romiSscWGWJCczFLe9RFhM3d1zpL
|
|
|
|
|
2019-09-13 09:03:53 +00:00
|
|
|
## Contact
|
|
|
|
|
|
|
|
Feel free to join our Freenode IRC channel at #nitter, or our
|
|
|
|
[Matrix server](https://riot.im/app/#/room/#nitter:matrix.org).
|
2019-09-23 23:16:24 +00:00
|
|
|
You can email me at zedeus@pm.me if you wish to contact me personally.
|