- 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
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.
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 |
![]() |
![]() |
![]() |
![]() |
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)
- Download
Titano-Setup-<version>.exe(Titano, Uploader and, optionally, Server) orTitano-Uploader-Setup-<version>.exefrom the latest release. - Check the download (optional, recommended): in PowerShell run
Get-FileHash .\Titano-Setup-<version>.exe -Algorithm SHA256and compare the value with the line for that file inSHA256SUMSof the same release. - Run the setup. It installs for the current user into
%LOCALAPPDATA%\Programs\Titanowithout administrator rights; choose All users to install intoProgram 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
SHA256SUMSand 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>.zipkeeps its data in adatafolder next toTitano.exe(because of theportable.txtfile). 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>;:nightlyfollows development and is not for production use). Multi-arch:linux/amd64andlinux/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_*(seedocker-compose.yml) or/data/server.json. Rundocker run --rm ghcr.io/alby96/titano-server:latest --helpfor the list.
Titano Server on Unraid
- Install the official postgresql17 template from Community Applications. Create a database
titanoowned by a roletitano(for example withdocker exec -it postgresql17 psql -U postgres -c "CREATE ROLE titano LOGIN PASSWORD '…'" -c "CREATE DATABASE titano OWNER titano"). - In Docker › Template repositories add
https://github.com/alby96/titano-releasesand save. - 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). - 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.




