2019-06-21 03:17:21 +02:00
|
|
|
# Nitter (WIP)
|
|
|
|
|
|
|
|
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-06-23 00:48:45 +02:00
|
|
|
- AGPLv3 licensed, no proprietary instances permitted
|
2019-06-21 03:17:21 +02:00
|
|
|
- Dark theme
|
2019-06-24 22:40:48 +02:00
|
|
|
- Lightweight (for [@nim_lang](https://twitter.com/nim_lang), 36KB vs 580KB from twitter.com)
|
2019-06-21 03:17:21 +02:00
|
|
|
|
|
|
|
## Installation
|
2019-06-24 01:34:30 +02:00
|
|
|
|
2019-06-21 03:17:21 +02:00
|
|
|
```bash
|
|
|
|
git clone https://github.com/zedeus/nitter
|
|
|
|
cd nitter
|
|
|
|
nimble build
|
|
|
|
```
|
|
|
|
|
2019-06-23 00:48:45 +02:00
|
|
|
To run, `./nitter`. It's currently not possible to change any settings or things
|
|
|
|
like the title, this will change as the project matures a bit. For now the focus
|
|
|
|
is on implementing missing features.
|
2019-06-21 03:17:21 +02:00
|
|
|
|
2019-06-23 00:48:45 +02:00
|
|
|
## Todo (roughly in this order)
|
2019-06-24 01:34:30 +02:00
|
|
|
|
2019-07-01 04:58:54 +02:00
|
|
|
- Search (images/videos, hashtags, etc.)
|
2019-06-29 14:11:23 +02:00
|
|
|
- Hiding retweets, showing replies, etc.
|
2019-07-02 03:32:17 +02:00
|
|
|
- Media carousel below profile
|
|
|
|
- Media-only/gallery view
|
2019-06-29 14:11:23 +02:00
|
|
|
- Nitter link previews
|
2019-06-23 00:48:45 +02:00
|
|
|
- Server configuration
|
2019-06-29 14:11:23 +02:00
|
|
|
- Caching (waiting for [moigagoo/norm#19](https://github.com/moigagoo/norm/pull/19))
|
2019-07-02 03:32:17 +02:00
|
|
|
- Twitter "Cards" (link previews)
|
2019-07-01 04:58:54 +02:00
|
|
|
- Simple account system with customizable feed
|
2019-07-02 03:32:17 +02:00
|
|
|
- Emoji support (WIP, needs font)
|
2019-06-23 14:34:19 +02:00
|
|
|
- Video support with hls.js
|
|
|
|
- Json API endpoints
|
2019-06-29 14:11:23 +02:00
|
|
|
- Themes
|
2019-06-21 20:36:00 +02:00
|
|
|
- Nitter logo
|
2019-06-21 03:17:21 +02:00
|
|
|
|
|
|
|
## Why?
|
2019-06-24 01:34:30 +02:00
|
|
|
|
2019-06-23 00:48:45 +02:00
|
|
|
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 essentially browse Twitter without JavaScript, while
|
2019-07-01 04:58:54 +02:00
|
|
|
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.
|
2019-06-21 03:17:21 +02:00
|
|
|
|
|
|
|
## Screenshot
|
|
|
|
|
|
|
|
![nitter](/screenshot.png)
|