Merge branch 'master' into add-usenet-support

.github/FUNDING.yml

@@ -0,0 +1,2 @@
+github: maxdorninger
+buy_me_a_coffee: maxdorninger

.gitignore

@@ -9,6 +9,8 @@ tv/*
 log.txt
 res/*
 media_manager/indexer/indexers/prowlarr.http
+*.egg-info
+.env
 
 
 web/cache/
@@ -35,3 +37,9 @@ web/!.env.test
 # Vite
 web/vite.config.js.timestamp-*
 web/vite.config.ts.timestamp-*
+
+# pycache
+__pycache__
+
+# Postgres
+/postgres

README.md

@@ -62,6 +62,9 @@ other services.
 - [x] improve reliability of scheduled tasks
 - [x] add notification system
 - [x] add sequence diagrams to the documentation
+- [ ] provide example configuration files
+- [ ] make media sorting algorithm configurable
+- [ ] add usenet support
 - [ ] add in-depth documentation on the architecture of the codebase
 - [ ] make indexer module multithreaded
 - [ ] add support for deluge and transmission
@@ -81,6 +84,38 @@ See the [open issues](hhttps://maxdorninger.github.io/MediaManager/issues) for a
 ![Screenshot 2025-06-28 222908](https://github.com/user-attachments/assets/193e1afd-dabb-42a2-ab28-59f2784371c7)
 
 
+## Developer Quick Start
+
+```bash
+  pip install uv
+  uv venv
+  # Activate the virtual environment
+  uv pip install -e .
+```
+```bash
+docker compose up db -d
+```
+
+```bash
+uv run alembic upgrade head
+```
+
+### Get the frontend up and running
+
+```bash
+cd /web && npm install
+```
+
+### Now start the backend and frontend
+```bash
+fastapi dev /media_manager/main.py --reload --host
+```
+
+```bash
+cd /web && npm run dev
+```
+
+
 <!-- LICENSE -->
 ## License
 

alembic/versions/93fb07842385_initial_migration.py

@@ -22,7 +22,6 @@ depends_on: Union[str, Sequence[str], None] = None
 def upgrade() -> None:
     """Upgrade schema."""
     # ### commands auto generated by Alembic - please adjust! ###
-
     # Create user table
     op.create_table(
         "user",
@@ -250,7 +249,6 @@ def upgrade() -> None:
 
     # ### end Alembic commands ###
 
-
 def downgrade() -> None:
     """Downgrade schema."""
     # ### commands auto generated by Alembic - please adjust! ###

media_manager/config.py

@@ -5,11 +5,12 @@ from pydantic_settings import BaseSettings
 
 
 class BasicConfig(BaseSettings):
-    image_directory: Path = "/data/images"
-    tv_directory: Path = "/data/tv"
-    movie_directory: Path = "/data/movies"
-    torrent_directory: Path = "/data/torrents"
-    usenet_directory: Path = "/data/usenet"
+    image_directory: Path = Path(__file__).parent.parent / "data" / "images"
+    tv_directory: Path = Path(__file__).parent.parent / "data" / "tv"
+    movie_directory: Path = Path(__file__).parent.parent / "data" / "movies"
+    torrent_directory: Path = Path(__file__).parent.parent / "data" / "torrents"
+    usenet_directory: Path = Path(__file__).parent.parent / "data" / "usenet"
+
     FRONTEND_URL: AnyHttpUrl = "http://localhost:3000/"
     CORS_URLS: list[str] = []
     DEVELOPMENT: bool = False

pyproject.toml

@@ -33,3 +33,7 @@ dependencies = [
     "pillow-avif-plugin>=1.5.2",
     "sabnzbd-api>=0.1.2",
 ]
+
+[tool.setuptools.packages.find]
+include = ["media_manager*"]
+exclude = ["web*", "Writerside*", "metadata_relay*", "tests*"]