2026-08-01 16:29:00 +02:00
15 changed files with 29 additions and 23 deletions
@@ -7,14 +7,14 @@
 A small web front end for assembling Instagram-compatible HDR JPEGs (gain
 map) from an SDR export and an HDR export out of Lightroom or Camera Raw.

-The gain-map assembly logic ([app/assembler.py](app/assembler.py)) is
+The gain-map assembly logic ([src/script/app/assembler.py](src/script/app/assembler.py)) is
 adapted from [kostis-kounadis/instagram-hdr-assembler](https://github.com/kostis-kounadis/instagram-hdr-assembler),
 itself based on the reverse-engineering work of
 [karachungen/instagram-hdr-converter](https://github.com/karachungen/instagram-hdr-converter).
 Original MIT license kept in [LICENSE](LICENSE). 


-![Instagram HDR Assembler screenshot](screenshots/insta-hdr-1.png)
+![Instagram HDR Assembler screenshot](illustration/insta-hdr-1.png)

 ## How it works

@@ -27,9 +27,7 @@ COPY requirements.txt .
 RUN pip install --no-cache-dir -r requirements.txt

 COPY main.py .
-COPY app/ app/
-COPY templates/ templates/
-COPY static/ static/
+COPY src/ src/
 COPY LICENSE VERSION ./
 COPY docker/entrypoint.sh /app/entrypoint.sh
 RUN chmod +x /app/entrypoint.sh
@@ -8,18 +8,21 @@ LICENSE). Gives you a browser form instead of a terminal, and
 surfaces the assembly report (including the "GainMapMin is negative"
 warning) on a results page.

-This file is just the entry point — see app/ for the app itself:
-  app/config.py       constants
-  app/jobs.py         in-memory job registry + heartbeat/reaper
-  app/validation.py   upload + Instagram resolution checks
-  app/assembler.py    gain-map assembly pipeline
-  app/routes.py       Flask routes
+This file is just the entry point — see src/script/app/ for the app itself:
+  src/script/app/config.py       constants
+  src/script/app/jobs.py         in-memory job registry + heartbeat/reaper
+  src/script/app/validation.py   upload + Instagram resolution checks
+  src/script/app/assembler.py    gain-map assembly pipeline
+  src/script/app/routes.py       Flask routes

 Run directly:      python3 main.py
 Run in Docker:      see Dockerfile (gunicorn main:app)
 """
 import os
 import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent / "src" / "script"))

 from app import create_app
 from app.assembler import check_dependencies
@@ -2,15 +2,15 @@
 from flask import Flask

 from . import jobs
-from .config import BASE_DIR, MAX_CONTENT_LENGTH, VERSION
+from .config import ASSETS_DIR, MAX_CONTENT_LENGTH, TEMPLATES_DIR, VERSION
 from .routes import register_routes


 def create_app() -> Flask:
    app = Flask(
        __name__,
-        template_folder=str(BASE_DIR / "templates"),
-        static_folder=str(BASE_DIR / "static"),
+        template_folder=str(TEMPLATES_DIR),
+        static_folder=str(ASSETS_DIR),
    )
    app.config["MAX_CONTENT_LENGTH"] = MAX_CONTENT_LENGTH

@@ -1,9 +1,14 @@
 """Shared constants for the HDR-to-Instagram web front."""
 from pathlib import Path

-BASE_DIR = Path(__file__).resolve().parent.parent
-JOBS_DIR = BASE_DIR / "jobs"
-VERSION = (BASE_DIR / "VERSION").read_text().strip()
+# This file lives at <repo root>/src/script/app/config.py.
+SRC_DIR = Path(__file__).resolve().parent.parent.parent
+REPO_ROOT = SRC_DIR.parent
+
+TEMPLATES_DIR = SRC_DIR / "templates"
+ASSETS_DIR = SRC_DIR / "assets"
+JOBS_DIR = REPO_ROOT / "jobs"
+VERSION = (REPO_ROOT / "VERSION").read_text().strip()

 ALLOWED_SDR_EXT = {".jpg", ".jpeg"}
 ALLOWED_HDR_EXT = {".jpg", ".jpeg", ".tif", ".tiff"}
@@ -4,7 +4,7 @@
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Instagram HDR Assembler</title>
-  <link rel="stylesheet" href="{{ url_for('static', filename='style.css') }}">
+  <link rel="stylesheet" href="{{ url_for('static', filename='css/style.css') }}">
 </head>
 <body>
  <div class="wrap">
@@ -61,11 +61,11 @@
    <p class="version">Instagram HDR Assembler v{{ app_version }}</p>
    <div class="repo-links">
      <a href="https://git.djeex.fr/Djeex/insta-hdr-converter" target="_blank" rel="noopener">
-        <span class="icon"><img src="{{ url_for('static', filename='gitea.svg') }}" alt=""></span>
+        <span class="icon"><img src="{{ url_for('static', filename='img/gitea.svg') }}" alt=""></span>
        Gitea
      </a>
      <a href="https://github.com/Djeex/insta-hdr-converter" target="_blank" rel="noopener">
-        <span class="icon"><img src="{{ url_for('static', filename='github.svg') }}" alt=""></span>
+        <span class="icon"><img src="{{ url_for('static', filename='img/github.svg') }}" alt=""></span>
        GitHub
      </a>
    </div>
@@ -4,7 +4,7 @@
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Instagram HDR Assembler — Result</title>
-  <link rel="stylesheet" href="{{ url_for('static', filename='style.css') }}">
+  <link rel="stylesheet" href="{{ url_for('static', filename='css/style.css') }}">
 </head>
 <body>
  <div class="wrap">
@@ -46,11 +46,11 @@
    <p class="version">Instagram HDR Assembler v{{ app_version }}</p>
    <div class="repo-links">
      <a href="https://git.djeex.fr/Djeex/insta-hdr-converter" target="_blank" rel="noopener">
-        <span class="icon"><img src="{{ url_for('static', filename='gitea.svg') }}" alt=""></span>
+        <span class="icon"><img src="{{ url_for('static', filename='img/gitea.svg') }}" alt=""></span>
        Gitea
      </a>
      <a href="https://github.com/Djeex/insta-hdr-converter" target="_blank" rel="noopener">
-        <span class="icon"><img src="{{ url_for('static', filename='github.svg') }}" alt=""></span>
+        <span class="icon"><img src="{{ url_for('static', filename='img/github.svg') }}" alt=""></span>
        GitHub
      </a>
    </div>