This repository has been archived on 2022-06-28. You can view files and clone it, but cannot push or open issues or pull requests.
Yotter/README.md

135 lines
9.0 KiB
Markdown
Raw Normal View History

2020-09-04 15:42:23 +05:30
<p align="center"> <img width="700" src="app/static/img/banner.png"> </img></p>
<p align="center">
2020-09-08 01:51:57 +05:30
<a href="https://www.gnu.org/licenses/gpl-3.0"><img alt="License: GPL v3" src="https://img.shields.io/badge/License-AGPLv3-blue.svg"></img></a>
2020-09-04 15:42:23 +05:30
<a href="https://github.com/pluja/Yotter"><img alt="Development state" src="https://img.shields.io/badge/State-Beta-blue.svg"></img></a>
<a href="https://github.com/pluja/Yotter/pulls"><img alt="Pull Requests Welcome" src="https://img.shields.io/badge/PRs-Welcome-green.svg"></img></a>
<a href="https://github.com/pluja/Yotter/tree/master"><img alt="Formerly named Parasitter" src="https://img.shields.io/badge/Formerly-Parasitter-blue.svg"></img></a>
</p>
Yotter allows you to follow and gather all the content from your favorite Twitter and YouTube accounts in a *beautiful* feed so you can stay up to date without compromising your privacy at all. Yotter is written with Python and Flask and uses Semantic-UI as its CSS framework.
Yotter is possible thanks to several open-source projects that are listed on the [Powered by](#powered-by) section. Make sure to check out those awesome projects!
2020-09-05 12:44:19 +05:30
# Index:
2020-09-04 15:42:23 +05:30
* [Why](#why)
* [Features](#features)
* [Screenshots](#screenshots)
* [Privacy and Security](#privacy)
2020-09-05 12:22:30 +05:30
* [Public instances](#public-instances)
2020-09-19 12:43:03 +05:30
* [Self hosting](https://github.com/ytorg/Yotter/blob/dev-indep/SELF-HOSTING.md)
2020-09-20 13:16:10 +05:30
* [Update the server](https://github.com/ytorg/Yotter/blob/dev-indep/SELF-HOSTING.md#updating-the-server)
2020-09-07 02:16:20 +05:30
* [Configure server](#configure-the-server)
2020-09-05 19:04:13 +05:30
* [Contributing and contact](#contributing)
2020-09-04 15:42:23 +05:30
* [Powered by](#powered-by)
* [Donate](#donate)
2020-09-05 12:44:19 +05:30
# Why
2020-09-04 15:42:23 +05:30
At first I started working on this project as a solution for following Twitter accounts (a thing that can't be done with Nitter) and getting a Twitter-like feed. Weeks later the leader of Invidious, Omar Roth, announced that he was stepping away from the project. As an Invidious active user, this made me think that a new alternative was needed for the community and also an alternative with an easier language for most people (as Invidious is written in Crystal). So I started developing a 'written-in-python Invidious alternative' and it went quite well.
I hope that this project can prosperate, gain contributors, new instances and create a good community around it.
2020-09-05 12:44:19 +05:30
# Features:
2020-09-04 15:42:23 +05:30
- [x] No Ads.
2020-09-05 15:03:43 +05:30
- [x] No Javascript needed*
2020-09-04 15:42:23 +05:30
- [x] Minimalist.
- [x] Search on Twitter and Youtube.
- [x] Zero connections to Google/Twitter on the client.
- [x] Follow Twitter accounts.
- [x] Follow Youtube accounts.
2020-09-05 13:31:10 +05:30
- [x] Play Youtube videos on background on Android.
2020-09-20 16:00:18 +05:30
- [x] Play only audio from youtube to save data.
2020-09-04 15:42:23 +05:30
- [x] Save your favourite Tweets.
- [x] Tor-friendly.
- [x] Terminal-browser friendly.
2020-09-05 15:03:43 +05:30
*Video player is VideoJS, which uses JavaScript. But if JavaScript is disabled Yotter still works perfectly and uses the default HTML video player.
2020-09-04 15:42:23 +05:30
> And many more to come!
2020-09-05 12:44:19 +05:30
# Privacy
2020-09-04 15:42:23 +05:30
#### Connections
Yotter cares about your privacy, and for this it will never make any connection to Twitter or Youtube on the client. Every request is proxied through the Yotter server; video streaming, photos, data gathering, scrapping, etc.
The Yotter server connects to Google (Youtube) and Nitter in order to gather all the necessary data. Then it serves it (proxyed through itself) to the client. This means that as a client, you will never connect to Google - the Yotter server will do it for you. So if you want to set up a Yotter server for privacy reasons I recommend you to set it up on a remote VPS so you don't share your IP with Google or use a VPN on the server.
If you don't mind exposing your IP making requests to Google then you can set it up wherever you want. Even with this method you will **avoid all trackers, ads, heavy-loaded pages, etc**. - Even with this method, you can stay safe if you use a VPN to hide your IP.
#### Your data
The only things the database stores are:
* Hash of the password
* Username
* List of followed users
* List of saved posts
* Some user configurations (Dark theme, etc)
This data will never be used for any other purpose than offering the service to the user. It's not sent anywhere, never.
#### Security
Only the hash of your password is stored on the database. Also, no personal information of any kind is required nor kept, if a hacker gets access to the database the only thing they could do would be to follow/unfollow some accounts. So there's no motivation in 'hacking' Yotter.
I always recommend self-hosting, as you will be the only person with access to the data.
> Important note: The **client** never connects to Google / Youtube however, the server does in order to gather all the necessary things!
2020-09-05 12:44:19 +05:30
# Public Instances
2020-09-26 18:46:14 +05:30
| name |server location|max users|registrations|
| ------------ | ------------ | ------------ |------------|
2020-09-27 13:24:27 +05:30
| https://yotter.xyz |Germany| 75 users|<img src="https://yotter.xyz/registrations_status/icon?2" width="17">|
2020-09-26 23:20:27 +05:30
| https://yotter.kavin.rocks/ |India| 100 users |<img src="https://yotter.kavin.rocks/registrations_status/icon?1" width="15">|
| https://yotter.jank.media/ |Germany| 100 users|<img src="https://yotter.jank.media/registrations_status/icon?1" width="15">|
2020-09-05 12:22:30 +05:30
2020-09-05 12:44:19 +05:30
## Configure the server
2020-09-04 15:42:23 +05:30
You will find in the root folder of the project a file named `yotter-config.json`. This is the global config file for the Yotter server.
Currently available config is:
2020-09-10 13:08:50 +05:30
* **serverName**: Name of the server. Format: `example.com`
2020-09-05 18:13:28 +05:30
* **nitterInstance**: Nitter instance that will be used when fetching Twitter content. Format must be `https://<NitterInstance.tld>/`
2020-09-04 15:42:23 +05:30
* **maxInstanceUsers**: Max users on the instance. When set to `0` it closes registrations.
2020-09-10 13:08:50 +05:30
* **serverLocation**: Location of the server.
2020-09-07 02:15:43 +05:30
* **restrictPublicUsage**: When set to `false` the instance allows non-registered users to use some routes (i.e /watch?v=..., /ytsearch, /channel...). See [this section](https://github.com/pluja/Yotter/blob/dev-indep/SELF-HOSTING.md#removing-log-in-restrictions)
2020-09-10 13:08:50 +05:30
* **nginxVideoStream**: Wether or not to use Nginx as streaming engine. It is recommended for public instances. [See this link]()
* **maintenance_mode**: Activates a message on the server warning users of maintenance mode.
* **show_admin_message**: Shows a message from the admin with title as `admin_message_title` and body as `admin_message`
2020-09-20 13:12:25 +05:30
* **admin_user**: Username of the admin user.
* **max_old_user_days**: Maximum days for a user to be inactive, otherwise will be deleted if admin uses the action.
* **donation_url**: Adds a link to a donation method for the instance.
2020-09-04 15:42:23 +05:30
2020-09-05 18:11:59 +05:30
# Contributing
Contributors are always welcome. You can help in many ways: Coding, organizing, designing, [donating](#donate), maintaining... You choose what you want to help with!
We have a [Matrix](https://matrix.org/) room where we discuss anything related with Yotter, feel free to enter the room and start talking or reading. You can choose a Matrix client from [this list of Matrix clients](https://matrix.org/clients/). Also you will need to choose an instance to host your account, you can find Matrix instances [here](https://www.hello-matrix.net/public_servers.php).
<a href="https://matrix.to/#/!wqJnbUtEfitxtOsLFj:privacytools.io?via=privacytools.io&via=matrix.org"><img alt="Join Matrix" src="https://img.shields.io/badge/Join Room-Matrix-black.svg">
2020-09-05 19:04:13 +05:30
#### Other platforms:
<a href="https://reddit.com/r/Yotter"><img alt="Join Matrix" src="https://img.shields.io/badge/Reddit-r/Yotter-orange.svg">
2020-09-05 18:11:59 +05:30
2020-09-05 12:44:19 +05:30
# Powered by:
2020-09-04 15:42:23 +05:30
* [Nitter](https://nitter.net/)
* [youtube-dl](https://github.com/ytdl-org/youtube-dl)
* [Flask](https://flask.palletsprojects.com/)
* [SQLAlchemy](https://docs.sqlalchemy.org/en/13/)
* [Semantic-UI](https://semantic-ui.com)
* [requests-futures](https://github.com/ross/requests-futures)
* [microblog](https://github.com/miguelgrinberg/microblog)
* [Video.js](https://videojs.com/)
* [My fork of youtube_search](https://github.com/pluja/youtube_search-fork)
2020-09-12 11:19:00 +05:30
* [Youtube-local](https://github.com/user234683/youtube-local)
2020-09-04 15:42:23 +05:30
2020-09-05 12:44:19 +05:30
# Donate
2020-09-04 15:42:23 +05:30
This project is completely free and Open Source and will always be.
Funding will be used 100% for opening and mantaining an online public instance of Yotter, this will be hosted on Netcup and will (at first) be the *VPS 500 G8*. I mention all of this in case you want to check the prices.
#### Crypto (preferred):
2020-09-05 16:10:14 +05:30
- **Bitcoin**: `bc1q5y3g907ju0pt40me7dr9fy5uhfhfgfv9k3kh3z`
2020-09-05 16:11:14 +05:30
- **Monero**: `48nQGAXaC6eFK2Wo7SVVyF9xL333gDHjzdmRL3XETEqbU3w4CcKjjHVUZPU4W3dg1oJL8be3iGtUAQsgV88dzbS7QNpZjC2`
2020-09-04 15:42:23 +05:30
#### Fiat:
- <a href="https://liberapay.com/pluja/donate"><img alt="Donate using Liberapay" src="https://liberapay.com/assets/widgets/donate.svg"></a>
## Screenshots
<p align="center"> <img width="720" src="https://i.imgur.com/6AfXO57.png"> </img></p>
<p align="center"> <img width="720" src="https://i.imgur.com/jipjySH.png"> </img></p>
<p align="center"> <img width="720" src="https://i.imgur.com/JMUW6VH.png"> </img></p>
<p align="center"> <img width="720" src="https://i.imgur.com/a7rM4sv.png"> </img></p>
<p align="center"> <img width="720" src="https://i.imgur.com/skXFMqE.png"> </img></p>
<p align="center"> <img width="720" src="https://i.imgur.com/AurVw5M.png"> </img></p>