Skip to content

Install ​

System Requirement ​

PlatformMinimum Version
AndroidAndroid 7.0 (API level 24)
iOSiOS 15.0
WindowsWindows 10, x64
macOSmacOS 12.0
LinuxDebian 10, x64 1
Web2https://chaldea.center
Web(China)https://cn.chaldea.center

1 Only Debian based Linux distributions are supported and tested. While it may work on other Linux distributions, we cannot guarantee full compatibility nor offer technical support for issues arising from those platforms at this time.

2 Mobile browser is not recommended due to bad performance and compatibility. Starting from 2.5.0, newer browser version is required: the latest 2 versions of Chrome/Edge/Firefox, and Safari 15.6+. See WeakRef and globalThis

Check Flutter docs for more about supported platforms.

TIP

Don't run multiple instances or web pages together, otherwise data will be overridden by each other.

TIP

If you encounter installation/startup problems, please check Notes first.

Download ​

Google Play ​

Get it on Google PlayGet it on F-droid

Get it on Google Play

App Store ​

Download on the App Store

Download on the App Store

TIP

Including iOS App Store and Mac App Store

GitHub Release ​

Contains Android, Windows and Linux binary assets.

If the latest version doesn't contain the platform you want, please check the previous versions.

Upgrade ​

This chapter mainly targets the Windows / Linux desktop version — see the subsections below for auto upgrade, manual upgrade and rollback. macOS and Android upgrades are simple:

  • macOS: updated via the App Store.
  • Android: updated via the app store, or by installing the new APK over the old one — no uninstallation needed.

For the desktop version, user data lives in the userdata folder next to the executable. Upgrades and uninstallation never touch it; to back up your data manually, just copy the userdata folder.

In-App Auto Upgrade ​

The app checks for new versions automatically on launch; you can also check manually in Settings → About → Check Update. Click "Update" and the app will handle everything: download → integrity check → back up the old version → replace files → restart.

  • The previous version's program files are automatically backed up to _backups/chaldea-backup-<version>/ next to the executable (the most recent 3 backups are kept by default).
  • When the download finishes, the app pauses and asks for confirmation. Choose "Later" to keep using the current version — the downloaded installer is kept, so continuing the upgrade later won't download it again.
  • The auto upgrade never modifies user data in userdata. Still, in case of extreme accidents (power loss, disk failure), consider copying the userdata folder elsewhere before upgrading.

Manual Upgrade ​

  1. Download the new archive for your platform from the release page.
  2. Delete (or move away) everything in the app folder EXCEPT userdata and _backups.
  3. Extract the new archive into the same app folder.
  4. Run the app and confirm the version number has changed. On Linux, if you get Permission denied, run chmod +x chaldea in a terminal.

Rollback ​

  • Automatic rollback: if an upgrade is interrupted (power loss, disk error, etc.), the updater script restores the previous version and relaunches it automatically.

  • Manual restore: open the _backups folder and enter the chaldea-backup-<version> folder you want to restore:

    • Windows: right-click restore.ps1 and choose "Run with PowerShell";
    • Linux: run sh restore.sh in a terminal.

    The script restores that version into the app folder and launches it. Restoring only overwrites program files — userdata is not affected.

Notes ​

Android ​

All android ABIs(arm64-v8a, armeabi-v7a, x86_64) are merged into one apk in v2.x.

Windows ​

TIP

Please run the app after decompression. And save to non-system folder: system folders like Program Files or C:\ require admin permission, which breaks data saving and auto-upgrade.

Error: VCRUNTIME140_1.dll was not found

Recent releases bundle the VC runtime DLLs (vcruntime140.dll, etc.), so this error should not appear after a normal extraction. If it still does, please install Microsoft Visual C++ redistributable package and restart again.

macOS ​

TIP

The macOS version is only available on Mac App Store.

Linux ​

If app cannot be started, try to run it from terminal ./chaldea and check the possible error.

Since v2.3.0, desktop app can be shown in system tray (disabled by default, can be enabled in the in-app display settings), and libappindicator is required in linux system. If it doesn't exist in your system, please install it before launching chaldea app, otherwise startup will fail silently. If the app crashes after enabling the tray, turn off "System Tray" in the display settings; if the app can no longer be opened, remove the "showSystemTray": true entry from userdata/user/settings.json (or simply delete the whole file if you are not familiar with json) to reset the setting.

For Debian based Linux, you can install it through the following command:

sh
sudo apt-get install libayatana-appindicator3-dev
# or
sudo apt-get install appindicator3-0.1 libappindicator3-dev

Releases ​

For FGO game apk, please visit FGO APK.

This section lists recent Chaldea stable and beta download links for Android, Linux and Windows.

If you have trouble downloading from the Github link, please use the Proxy link.

More releases can be found at Github Releases

Tips: beta version is the latest preview version, updated when source code got updated.

To download the latest stable version:


Powered by Vitepress