OpenLyst Multi-Platform Builds

This project provides builds for OpenLyst projects across multiple platforms.

📦 OpenLyst Builds — Releases & Repositories — A GitHub Pages site listing all pre-releases, repositories (AltStore, F-Droid, Homebrew, AUR, Docker), and GitHub releases in one place. Enable Pages in repo Settings → Pages → Source: Deploy from branch → Branch: main, folder: /docs.

Unified Build Script

All repositories are generated using a single unified build script (build.py) that supports AltStore (iOS), F-Droid (Android), Homebrew (macOS/Linux), and AUR (Arch Linux).

Usage

# Build all repositories
python build.py --target all

# Build specific targets
python build.py --target altstore          # AltStore only
python build.py --target fdroid            # F-Droid only
python build.py --target homebrew          # Homebrew only
python build.py --target aur               # AUR PKGBUILDs only (for Arch Linux)
python build.py --target altstore,fdroid   # Multiple targets

# Homebrew platform options
python build.py --target homebrew --platform macOS   # macOS only
python build.py --target homebrew --platform Linux   # Linux only
python build.py --target homebrew --platform both    # Both platforms

# Additional options
python build.py --target all --calculate-sha256      # Calculate SHA256 hashes
python build.py --target all --verbose               # Verbose logging

GitHub Actions

Run the "Build All Repositories" workflow to update all repositories at once, or use the "Build Apps" workflow to build app binaries. Configure the following in Actions (workflow run form) and Settings → Secrets and variables → Actions as needed.

Build All Repositories (`build-unified.yml`)

Inputs (shown in the workflow run form):

Variable	Description	Default
`target`	Build target	`all`
	Options: `all`, `altstore`, `fdroid`, `homebrew`, `aur`
`platform`	Homebrew platform (only used when target is homebrew)	`both`
	Options: `both`, `macOS`, `Linux`
`calculate_hashes`	Calculate SHA256 hashes (slower)	`false`

Secrets (Settings → Secrets and variables → Actions) — required only for AUR pushes:

Secret	Description
`AUR_SSH_KEY_BASE64`	Base64-encoded SSH private key with push access to AUR packages
`AUR_SSH_KEY_PASSWORD`	Passphrase for the key (leave empty if unencrypted)

Build Apps (`build.yml`)

Inputs (workflow run form) — every variable:

Variable	Description	Default
`build_doudou`	Build Doudou	`false`
`doudou_platforms`	Doudou platforms (comma-separated: ios, android, windows, linux, macos)	`ios,android,windows,linux,macos`
`doudou_commit_hash`	Doudou commit hash (empty = latest)	`''`
`build_docan`	Build Docan	`false`
`docan_platforms`	Docan platforms (comma-separated: ios, android, windows, linux, macos, web)	`ios,android,windows,linux,macos,web`
`docan_commit_hash`	Docan commit hash (empty = latest)	`''`
`build_finar`	Build Finar	`false`
`finar_platforms`	Finar platforms (comma-separated: ios, android, windows, linux, macos, web, docker)	`ios,android,windows,linux,macos,web,docker`
`finar_commit_hash`	Finar commit hash (empty = latest)	`''`
`build_klit`	Build Klit	`false`
`klit_platforms`	Klit platforms (comma-separated: ios, android, windows, linux, macos)	`ios,android,windows,linux,macos`
`klit_commit_hash`	Klit commit hash (empty = latest)	`''`
`build_repstore`	Build Repstore	`false`
`repstore_platforms`	Repstore platforms (comma-separated: ios, android, windows, linux, macos, web)	`ios,android,windows,linux,macos,web`
`repstore_commit_hash`	Repstore commit hash (empty = latest)	`''`
`build_opentorrent`	Build OpenTorrent	`false`
`opentorrent_platforms`	OpenTorrent platforms (comma-separated: ios, android, windows, linux, macos, web)	`ios,android,windows,linux,macos,web`
`opentorrent_commit_hash`	OpenTorrent commit hash (empty = latest)	`''`

Secrets (Settings → Secrets and variables → Actions) — every variable:

AUR (for AUR package pushes):

Secret	Description
`AUR_SSH_KEY_BASE64`	Base64-encoded SSH private key with push access to AUR packages
`AUR_SSH_KEY_PASSWORD`	Passphrase for the key (leave empty if unencrypted)

Android signing (optional; omit for unsigned builds). Doudou:

Secret	Description
`DOUDOU_KEYSTORE_BASE64`	Base64-encoded Android keystore file
`DOUDOU_KEYSTORE_PASSWORD`	Keystore password
`DOUDOU_KEY_PASSWORD`	Key password
`DOUDOU_KEY_ALIAS`	Key alias in the keystore

Docan:

Secret	Description
`DOCAN_KEYSTORE_BASE64`	Base64-encoded Android keystore file
`DOCAN_KEYSTORE_PASSWORD`	Keystore password
`DOCAN_KEY_PASSWORD`	Key password
`DOCAN_KEY_ALIAS`	Key alias in the keystore

Finar:

Secret	Description
`FINAR_KEYSTORE_BASE64`	Base64-encoded Android keystore file
`FINAR_KEYSTORE_PASSWORD`	Keystore password
`FINAR_KEY_PASSWORD`	Key password
`FINAR_KEY_ALIAS`	Key alias in the keystore

Klit:

Secret	Description
`KLIT_KEYSTORE_BASE64`	Base64-encoded Android keystore file
`KLIT_KEYSTORE_PASSWORD`	Keystore password
`KLIT_KEY_PASSWORD`	Key password
`KLIT_KEY_ALIAS`	Key alias in the keystore

Repstore:

Secret	Description
`REPSTORE_KEYSTORE_BASE64`	Base64-encoded Android keystore file
`REPSTORE_KEYSTORE_PASSWORD`	Keystore password
`REPSTORE_KEY_PASSWORD`	Key password
`REPSTORE_KEY_ALIAS`	Key alias in the keystore

OpenTorrent:

Secret	Description
`OPENTORRENT_KEYSTORE_BASE64`	Base64-encoded Android keystore file
`OPENTORRENT_KEYSTORE_PASSWORD`	Keystore password
`OPENTORRENT_KEY_PASSWORD`	Key password
`OPENTORRENT_KEY_ALIAS`	Key alias in the keystore

AltStore (iOS)

Add this Source URL in AltStore: https://raw.githubusercontent.com/openlyst/builds/main/repo/apps.json
CDN URL (faster): https://cdn.jsdelivr.net/gh/openlyst/builds@main/repo/apps.json

Notes:

The source includes app permissions (privacy descriptions and entitlements) when available.

F-Droid (Android)

Repository URL: https://raw.githubusercontent.com/openlyst/builds/main/fdroid-repo
Add this repository in F-Droid client to access OpenLyst Android apps.

Homebrew (macOS/Linux)

Quick Setup

brew tap openlyst/builds

Installation

# Add the tap
brew tap openlyst/builds https://github.com/openlyst/builds.git

# Install apps
brew install openlyst/builds/app-name

# For cask applications on macOS
brew install --cask openlyst/builds/app-name

Available Commands

Command	Description
`brew update`	Update the tap
`brew search openlyst/builds/`	List available formulae
`brew install openlyst/builds/app-name`	Install an application
`brew uninstall app-name`	Uninstall an application
`brew info openlyst/builds/app-name`	Get formula info

AUR (Arch Linux)

The "Build All Repositories" workflow can update AUR packages from the Openlyst API. Known packages (finar-bin, klit-bin, doudou-bin, docan-bin) are updated automatically; any new app that has a Linux build (e.g. opentorrent-bin) gets a PKGBUILD generated—create the package on AUR first (e.g. via the AUR website), then the workflow can push to it.

To enable AUR pushes, add these GitHub repository secrets:

Secret	Description
`AUR_SSH_KEY_BASE64`	Base64-encoded private key (e.g. `cat ~/.ssh/id_ed25519 \| base64 -w0`) that has push access to the AUR packages above
`AUR_SSH_KEY_PASSWORD`	Passphrase for the key (leave empty if the key has no passphrase)

Run the workflow with target aur or all to update AUR packages to the latest version from the Openlyst API.

Docker

Docker images are published to GitHub Container Registry (ghcr.io) for web-based applications.

Available Images

App	Image	Description
Finar	`ghcr.io/justacalico/finar`	Jellyfin web client

Quick Start

# Pull the latest image
docker pull ghcr.io/justacalico/<app-name>:latest

# Run with default settings
docker run -d -p 8080:80 ghcr.io/justacalico/<app-name>:latest

Finar

A beautiful, modern Jellyfin client built with Flutter.

# Pull the image
docker pull ghcr.io/justacalico/finar:latest

# Run the container
docker run -d -p 8080:80 ghcr.io/justacalico/finar:latest

# Run with Jellyfin proxy (for CORS)
docker run -d -p 8080:80 -e JELLYFIN_URL=http://your-jellyfin-server:8096 ghcr.io/justacalico/finar:latest

Then open http://localhost:8080 in your browser.

Docker Compose

Example docker-compose.yml:

services:
  finar:
    image: ghcr.io/justacalico/finar:latest
    ports:
      - "8080:80"
    environment:
      - JELLYFIN_URL=http://your-jellyfin-server:8096  # Optional: for CORS proxy
    restart: unless-stopped

Available Tags

Tag	Description
`latest`	Latest stable release
`x.y.z`	Specific version (e.g., `1.0.0`)
`x.y.z-YYYY-MM-DD`	Version with build date

Development

Requirements

pip install -r requirements.txt

Project Structure

├── build.py                    # Unified build script
├── repo/                       # AltStore repository output
├── fdroid-repo/               # F-Droid repository output
├── homebrew-tap/              # Homebrew tap output
│   └── Formula/               # Homebrew formulae
└── .github/workflows/
    └── build-unified.yml      # Unified GitHub Actions workflow

Name		Name	Last commit message	Last commit date
Latest commit History 94 Commits
.github/workflows		.github/workflows
altstore-docs		altstore-docs
build-v2		build-v2
docs		docs
fdroid-repo		fdroid-repo
homebrew-tap		homebrew-tap
repo		repo
scripts		scripts
.gitignore		.gitignore
.gitlab-ci-build-apps.yml		.gitlab-ci-build-apps.yml
.gitlab-ci.yml		.gitlab-ci.yml
LICENSE		LICENSE
README.md		README.md
awd		awd
build.py		build.py
requirements.txt		requirements.txt

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

OpenLyst Multi-Platform Builds

Unified Build Script

Usage

GitHub Actions

Build All Repositories (`build-unified.yml`)

Build Apps (`build.yml`)

AltStore (iOS)

F-Droid (Android)

Homebrew (macOS/Linux)

Quick Setup

Installation

Available Commands

AUR (Arch Linux)

Docker

Available Images

Quick Start

Finar

Docker Compose

Available Tags

Development

Requirements

Project Structure

About

Uh oh!

Releases 113

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

OpenLyst Multi-Platform Builds

Unified Build Script

Usage

GitHub Actions

Build All Repositories (build-unified.yml)

Build Apps (build.yml)

AltStore (iOS)

F-Droid (Android)

Homebrew (macOS/Linux)

Quick Setup

Installation

Available Commands

AUR (Arch Linux)

Docker

Available Images

Quick Start

Finar

Docker Compose

Available Tags

Development

Requirements

Project Structure

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 113

Contributors

Uh oh!

Languages

Build All Repositories (`build-unified.yml`)

Build Apps (`build.yml`)