This is the root folder for a multi-repository project called Twitter Image Scraper.
This repository contains only a set of useful scripts to start the multiple components of the project.
The scripts were written for MacOS, but are easily adapted for Linux.
The complete project consist of 3 repositories:
- ntf-scraper - a Chrome extension that scrapes an open Twitter tab for images in tweets and allows to save them to a gallery
- ntf-backend - a Django headless back-end that works as image gallery, serving a REST API through Django REST Framework that allows to store/access images in the gallery
- ntf-frontend - a React web app that shows the gallery of saved images
It was once also possible to publish images saved in the gallery to a Tumblr-like blog website, but that's no longer possible.
Still, the code to do that was kept for purposes of future consultation.
The purpose of this project was to learn and practice useful technologies.
Clone this repository.
Then, inside of this repository's folder, clone the 3 repositories above.
Follow the instructions on the README of each repository.
Creates an admin user with credentials to access the Django Admin portal.
Open http://localhost:8000/admin to access the admin portal.
Run it once after installing ntf-backend. After that you only need to run it when you modify any of the DB models.
Starts the Django backend and the starts serving requests to the REST API.
Starts the celery worker, that was responsible for posting images to a selected external blog asynchronously, when this option was working.
Starts the React frontend, making it possible to access the webpage that displayes the image gallery.
When posting to external blogs was possible, it was also done through this webpage.
Open http://localhost:3000 to access the gallery.