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

48 lines
2.2 KiB
Markdown
Raw Normal View History

2020-07-13 03:12:28 +05:30
# Parasitter
2020-07-13 03:22:51 +05:30
<p align="center"> <img width="150" src="app/static/img/logo.png"> </img></p>
<p align="center"> Twitter via RSS with privacy </p>
2020-07-13 03:23:04 +05:30
<br>
2020-07-13 03:23:19 +05:30
Parasitter allows you to follow your favourite twitters without Twitter even knowing it. Rssitter uses [Nitter's](nitter.net) rss feed in order to gather the latest tweets from your favourite accounts and builds a *twitter-like* feed so you can read them. We will never connect you to Twitter so your privacy is safe when using Parasitter.
2020-07-13 03:14:56 +05:30
2020-07-13 04:13:13 +05:30
2020-07-13 04:06:16 +05:30
Parasitter is written with Python and Flask and uses Semantic-UI as its CSS framework.
2020-07-13 04:13:13 +05:30
## Security
2020-07-13 04:14:08 +05:30
Only the hash of your password is stored on the database. Also no personal information of any kind is kept on the app itself, if a hacker gets access to it only thing they could do would be to follow/unfollow some accounts.
2020-07-13 04:13:13 +05:30
I always recommend self-hosting, as you will be the only person with access to the data.
2020-07-13 12:30:38 +05:30
## Self hosting
2020-07-13 03:25:32 +05:30
1. Install `python3`, `pip3` and `git`.
2. Clone this repository:
- `git clone https://github.com/pluja/Parasitter.git`
3. Navigate to the project folder:
- `cd Parasitter`
2020-07-13 18:20:39 +05:30
4. [Optional] Prepare a virtual environment and activate it:
> Python lets you create virtual environments. This allows you to avoid installing all the `pip` packages on your system.
If you don't mind about that, you can jump to step **5.** and ignore everything about "[env]".
2020-07-13 03:14:56 +05:30
- `python3 -m venv venv`
- `source venv/bin/activate`
2020-07-13 18:20:39 +05:30
> Now you are inside of the virtual environment for python. All instructions wiht [env] indicate that must be done inside the env if you decided to create one.
5. [env] Update pip
2020-07-13 03:14:56 +05:30
- `pip install --upgrade pip`
2020-07-13 18:20:39 +05:30
6. [env] Install the dependencies:
2020-07-13 03:14:56 +05:30
- `pip3 install flask flask-sqlalchemy flask-migrate python-dotenv flask-wtf flask-login email-validator feedparser`
2020-07-13 03:25:32 +05:30
> It may require you to use *sudo*
2020-07-13 18:20:39 +05:30
7. [env] Initialize and prepare the database.
2020-07-13 03:14:56 +05:30
- `flask db init`
- `flask db migrate`
- `flask db upgrade`
2020-07-13 18:20:39 +05:30
8. [env] Run the application.
2020-07-13 03:14:56 +05:30
- `flask run`
2020-07-13 18:20:39 +05:30
9. Go to "http://localhost:5000/" and enjoy.
2020-07-13 03:22:51 +05:30
### Powered by:
* [Nitter](https://nitter.net)
* [Flask](https://flask.palletsprojects.com/)
* [SQLAlchemy](https://docs.sqlalchemy.org/en/13/)
2020-07-13 04:06:16 +05:30
* [Semantic-UI](https://semantic-ui.com)