Files
Chronos/deploy/releases-repo
Claude 411425b83a ci(release): push the image only after the tests, move :latest after the release
- The docker job waits for the Windows build and tests and pushes only :<v>;
  publish moves :latest with imagetools once the GitHub release exists and the
  tag is the newest stable one, so a failed or older re-published tag never
  moves it.
- The GitHub release is created before the public repository content, so the
  public SHA256SUMS never describes a release that does not exist.
- Stable release notes start from the previous stable tag.
- Raw links to the public repository follow its default branch.
- Public README and bug form name the Diagnostics row and its button.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
2026-10-03 10:07:18 +00:00
..

Titano

Titano turns folders of photos (RAW, JPEG, HEIC…) into finished time-lapse videos and keeps a lifetime archive of your shoots organised, verified and searchable — on one PC or on a shared server.

This repository publishes the installers, the Docker image instructions, the Unraid template and the translations for community review. Development happens elsewhere; please use the issues here for bugs and translation fixes.

Library

Components

Program Runs on What it does
Titano Windows 10 21H2+ / 11, x64 Desktop client: card import with hash verification, archive, analysis advisor, sequence editor, rendering with GPU encoders (H.264, HEVC, AV1)
Titano Uploader Windows 10 21H2+ / 11, x64 Small tray program that uploads photos, folders, cards and watch folders to a Titano Server
Titano Server Docker (linux/amd64, linux/arm64), Unraid, Windows Shared archive, users, resumable uploads, sync, background jobs, render delegation to GPU-equipped PCs, web admin panel
Jobs Rendering settings
Server Uploader

Requirements

  • Desktop programs: Windows 10 version 21H2 or later, or Windows 11, 64-bit (x64). 8 GB of memory or more is recommended for 4K renders. No other runtime is needed: the programs are self-contained.
  • Camera RAW files: Titano develops DNG, CR2, NEF, ARW, PEF and RAF on its own. With Microsoft's free Raw Image Extension installed, Windows' decoder is used first and covers the other formats (CR3, ORF, RW2…); without it they render from the full-size preview embedded by the camera. HEIC needs Microsoft's HEIF Image Extensions and HEVC Video Extensions.
  • Hardware encoding: any GPU whose driver provides Media Foundation encoders (NVIDIA, AMD, Intel). Without one, Titano encodes H.264 in software and its own formats (AVI, GIF, APNG, image sequences).
  • Server: Docker 20.10+ (or Unraid 6.12+) and PostgreSQL 16 or 17; or Windows 10/11/Server 2019+ x64.

Install, upgrade, uninstall (Windows)

  1. Download Titano-Setup-<version>.exe (Titano, Uploader and, optionally, Server) or Titano-Uploader-Setup-<version>.exe from the latest release.
  2. Check the download (optional, recommended): in PowerShell run Get-FileHash .\Titano-Setup-<version>.exe -Algorithm SHA256 and compare the value with the line for that file in SHA256SUMS of the same release.
  3. Run the setup. It installs for the current user into %LOCALAPPDATA%\Programs\Titano without administrator rights; choose All users to install into Program Files (Windows asks for permission).
  • Upgrade: Titano checks this repository at start (you can turn this off in Settings › Updates) and shows a notice when a new version exists. Download fetches the setup, verifies it against SHA256SUMS and shows it in Explorer; run it to upgrade in place. Your archive, settings and index are kept.
  • Uninstall: Windows Settings › Apps › Installed apps › Titano › Uninstall. Your photos and archive are never touched; the program data folder (%LOCALAPPDATA%\Titano) is removed only if you tick the option to do so.
  • Silent install (IT deployment): Titano-Setup-<version>.exe /S [/DIR="D:\Apps\Titano"] [/ALLUSERS] [/COMPONENTS=Titano,Uploader,Server] [/NODESKTOP] [/NOSTARTMENU] [/LANG=it]. Silent uninstall: "%LOCALAPPDATA%\Programs\Titano\Uninstall Titano.exe" /uninstall /S.
  • Portable: Titano-win-x64-portable-<version>.zip keeps its data in a data folder next to Titano.exe (because of the portable.txt file). Do not unpack it into a OneDrive or Dropbox folder.

Titano Server with Docker Compose

mkdir titano && cd titano
curl -LO https://raw.githubusercontent.com/alby96/titano-releases/main/docker/docker-compose.yml
curl -L -o .env https://raw.githubusercontent.com/alby96/titano-releases/main/docker/.env.example
# edit .env: TITANO_ADMIN_PASSWORD, TITANO_DB_PASSWORD, TITANO_ARCHIVE (folder of your archive), PUID/PGID, TZ
docker compose up -d

Open http://<host>:8080/admin, sign in as admin with the password from .env and choose a new one. Titano clients connect to https://<host>:8443; the first connection shows the server's certificate fingerprint, which the admin panel shows under Settings so you can compare them.

  • Image: ghcr.io/alby96/titano-server:latest (also :<version>; :nightly follows development and is not for production use). Multi-arch: linux/amd64 and linux/arm64.
  • Volumes: /archive (originals, sidecars, proxies, renders — the archive stays readable without Titano) and /data (settings, TLS certificate, uploads in progress, logs).
  • Upgrade: docker compose pull && docker compose up -d. Jobs in progress resume from their last checkpoint.
  • All settings: environment variables TITANO_* (see docker-compose.yml) or /data/server.json. Run docker run --rm ghcr.io/alby96/titano-server:latest --help for the list.

Titano Server on Unraid

  1. Install the official postgresql17 template from Community Applications. Create a database titano owned by a role titano (for example with docker exec -it postgresql17 psql -U postgres -c "CREATE ROLE titano LOGIN PASSWORD '…'" -c "CREATE DATABASE titano OWNER titano").
  2. In Docker › Template repositories add https://github.com/alby96/titano-releases and save.
  3. Docker › Add container › Template titano-server. Set the admin password, the database host (the PostgreSQL container's name or IP), password and the archive share (default /mnt/user/Timelapse).
  4. Open the WebUI (http://[IP]:8080/admin).

The template file is unraid/titano.xml.

Titano Server on Windows

Unpack Titano-Server-win-x64-<version>.zip (or choose the Server component in the setup). It uses SQLite in C:\ProgramData\Titano Server by default, or PostgreSQL with TITANO_DB=postgres and the TITANO_DB_* variables. Run Titano.Server.exe in a console, or install it as a Windows service from an administrator prompt with Titano.Server.exe --install-service (remove it with --uninstall-service).

Translations

Titano is written in English and Italian; every other language is machine-translated and marked as such in About. The source strings are in i18n/: en/<Area>.resx is the source, <language>/<Area>.<language>.resx the translation. To suggest a correction, open a Translation review issue with the key, the current text and your proposal — or the in-app Suggest a fix link in About, which leads here.

Verifying downloads

Every release carries SHA256SUMS. On Linux or macOS: sha256sum -c SHA256SUMS --ignore-missing. Titano's in-app update download performs the same check before showing the setup or portable zip. Signed builds carry an Authenticode signature; unsigned builds may show a SmartScreen prompt.

Support and security

  • Bugs: open a Bug report issue (attach the diagnostics bundle from Settings › Advanced › Diagnostics › Export bundle, or the server's from admin panel › Logs › Diagnostics; it contains logs and system information, never photos, passwords or tokens).
  • Security problems: see SECURITY.md — please do not open public issues for them.

Licence

Titano is proprietary software distributed free of charge under the End User Licence Agreement.