Install

1. Install vips:
   1. Go to the latest vips release for Windows.
   2. Download the asset for your platform architecture with -all- in the name.
   3. Extract the archive, or at least the bin subfolder, to a path of your choosing.
   4. Add the full path of the extracted bin folder to your Path environment variable. (An easy way is to press the ⊞ Win key, type "env", and hit Enter, then proceed in the GUI.)
   5. Restart any open shells/command prompts, and enter echo %Path% to ensure the environment has been updated.
2. To process photos/videos from iPhones, install libheif by following their instructions.
3. Install ffmpeg:

   curl.exe https://webi.ms/ffmpeg | powershell

4. Install uv:

   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

5. Download Timelinize (see above).
6. Extract the program, timelinize.exe.
7. Run the program (from the command line, for logs). We are not yet code-signed, so you will have to override built-in OS protections:
   • You will get a warning that this software is not signed. Click More info and then Run anyway.

1. Install libvips:

   brew install vips

2. To process photos/videos from iPhones, install libheif:

   brew install libheif

3. Install ffmpeg:

   brew install ffmpeg

   or

   curl https://webi.sh/ffmpeg | sh

4. Install uv:

   curl -LsSf https://astral.sh/uv/install.sh | sh

5. Download Timelinize (see above).
6. Extract the program, and make sure it is executable: chmod +x ./timelinize
7. Run the program from the Terminal (for logs). We are not yet code-signed, so you will have to override built-in OS protections: Follow these instructions to run apps from unidentified developers (that's me!). If the error you get says that Timelinize "is damaged," that's a lie: checksums probably match; the real problem is that Apple has placed it in "quarantine" because it was downloaded. You can either:
   • Do a two-finger click and select Open, twice (once for the warning, the second time to open it)
   • Or, open Terminal and run this command:

     xattr -d com.apple.quarantine ~/Downloads/timelinize

     (adjust path as needed). It should finally run, but if you can't open or create a timeline, Apple may be blocking access to your disk. The easiest way around this is to give Timelinize "Full Disk Access" in System Settings (or at least access to folders you'll be using).

1. Install libvips:
   • Debian/Ubuntu/Raspbian:

     sudo apt install -y libvips

   • Arch:

     sudo pacman -S libvips

2. To process photos/videos from iPhones, install libheif:
   • Debian/Ubuntu/Raspbian:

     sudo add-apt-repository ppa:ubuntuhandbook1/libheif
     sudo apt update
     sudo apt install libheif1 libheif-plugin-libde265

   • Arch:

     sudo pacman -S libvips

3. Install ffmpeg:
   • Debian/Ubuntu/Raspbian:

     sudo apt install -y ffmpeg

   • Arch:

     sudo pacman -S ffmpeg

4. Install uv:

   curl -LsSf https://astral.sh/uv/install.sh | sh

5. Download Timelinize (see above).
6. Extract the program, and make sure it is executable: chmod +x ./timelinize
7. Run ./timelinize. A browser tab should open automatically.

Pull the automated Docker image from GHCR:

docker pull ghcr.io/timelinize/timelinize/

It can be run like so:

docker run -p12002:12002 \
	-v /path/to/repo:/repo \
	-v /path/to/config:/app/.config/timelinize \
	ghcr.io/timelinize/timelinize

That will run Timelinize on port 12002, with the timeline repository mounted at /path/to/repo (change it to suit your needs) and the configuration directory mounted at /path/to/config (change it). When using Docker bind mounts like above, make sure the directories exist on your host machine and that they belong to the user ID 1000.