From 4a47655531fc6e74838c1e5890186d33c89523b6 Mon Sep 17 00:00:00 2001 From: Aroy-Art Date: Fri, 6 Oct 2023 10:09:01 +0200 Subject: [PATCH] Update: README.md --- README.md | 68 ++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 67 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 0626922..6074cae 100644 --- a/README.md +++ b/README.md @@ -19,8 +19,74 @@ My try to make a Social media archiving web tool with django and gallery-dl - - - [X] Image (With HTML img tag) - - - [ ] other text documents - --- + +## Usage +### Run without Docker + + * **Step 1:** Clone repo +```bash +git clone https://git.aroy-art.com/Aroy/Gallery-Archivist.git +``` + +* **Step 2:** Change dir to the new cloned repo +```bash +cd Gallery-Archivist +``` + +* **Step 3:** Make a python environment +```bash +python3 -m venv venv +``` + +* **Step 4:** Activate the new python environment +```bash +source ./venv/bin/activate +``` + +* **Step 5:** Install python dependencies +```bash +pip install -r requirements.txt +``` + +* **Step 6:** Copy environment config file and change it to your liking +```bash +cp env-sample .env +``` + +* **Step 7:** Change directory to `./archivist` +```bash +cd ./archivist +``` + +* **Step 8:** Run django server +```bash +python3 manage.py runserver +``` + +### Manual Import Data + +It is possible to import data from saved gallery-dl json files + +* **Step 1:** Make sure that you are in the root folder of the project. + +* **Step 2:** Make sure to activate the python environment. +```bash +source ./venv/bin/activate +``` + +* **Step 3:** Change directory to `./archivist` +```bash +cd ./archivist +``` + +* **Step 4:** Import the json data and media file from gallery-dl +replace `` with the path of the folder or json file to import + +```bash +python manage.py import_data +``` + ## Development *Note!* Instructions are made for a modern linux environment.