Triadfolio is a small personal tool I made for tracking my own Triple Triad collection. I’m sharing it here in case another card collector finds it useful too. It keeps card ownership and NPC progress in a local profile, helps identify missing rewards, and includes an experimental deck recommendation simulator.
Progress is recorded manually or imported from supported sources. Triadfolio does not read game state.
- Track 475 cards, NPC challenge status, reward completion, and Triple Triad achievement milestones using the bundled Patch 7.55 catalog.
- Search cards by name or in-game number, rarity, type, ownership, or any side value.
- Browse NPC rules, locations, fixed cards, random pools, and rewards, with direct card-to-NPC navigation.
- Open quests, duties, FATEs, and achievements on Lodestone, Console Games Wiki, Gamer Escape, or Huiji Wiki.
- Use English or Simplified Chinese for the interface and bundled game data.
- Keep multiple independent profiles and export portable JSON backups.
- Restore Triadfolio backups or import owned cards from FFTriadBuddy (desktop) settings.
- Generate and save experimental general, rule-specific, or NPC-specific deck presets.
All collection and progress data stays on your device and is not uploaded by Triadfolio. The application may make network requests to retrieve and cache card images or to open external reference sites.
Download the build for your platform from the repository's Releases page:
- macOS 13 or later on Apple silicon:
.dmg - Windows 10/11 x64:
.msior setup executable
The first public builds may not be notarized or signed with a commercial certificate. Your operating system may therefore ask you to confirm that you trust the downloaded application.
- Create a local profile. The profile name is only a label; any format is accepted.
- Open Cards and mark the cards you own, or use Import & Backup to merge or replace profile data.
- Open NPCs to record challenge progress and find opponents that still have missing reward cards.
- Open Achievements to search Triple Triad achievements, filter by calculated completion status, and inspect linked card rewards.
- Check Dashboard for the next collection, NPC, and achievement milestones.
- Optionally use Decks to compare reproducible heuristic recommendations and save useful presets.
Merging a Triadfolio backup combines owned cards and keeps the highest NPC progress (defeated → challenged → not challenged → unrecorded). Replacing uses the backup's cards, NPC statuses, and saved decks as the complete profile data. FFTriadBuddy (desktop) imports cards only because its NPC completion state does not reliably prove that an opponent was defeated.
Before every import, Triadfolio automatically saves the current profile as JSON and keeps its five most recent automatic backups. Use Import & Backup → Export for additional portable backups; exports contain owned card IDs, recorded NPC states, and saved decks.
Triadfolio stores profile data and automatic import backups in the operating system's application-data directory:
- macOS:
~/Library/Application Support/io.github.wcpp78p8dx-cyber.triadfolio - Windows:
%APPDATA%\io.github.wcpp78p8dx-cyber.triadfolio
The main database is triadfolio.sqlite3; dated JSON backups are under import-backups/<profile-id>/. Manual exports are saved wherever you choose in the save dialog. Automatic or manual JSON backups can be restored through Import & Backup. To restore a copied application-data folder, quit Triadfolio before replacing it.
Uninstalling the application may leave this directory behind. After saving any backup you want to keep, quit Triadfolio and delete the directory to remove its stored profiles and automatic backups.
Triadfolio does not connect to your game account, read game memory, or modify the game client. It cannot automatically discover the cards you own, the NPCs you have defeated, or achievements already earned. Card ownership and NPC victories must be recorded manually; achievement status is then calculated from those records.
Initial setup is easiest for players with newer or smaller collections. Players with many cards or previous NPC victories can still use Triadfolio, but reconstructing their existing progress may take some time.
Deck recommendations are experimental heuristics rather than guaranteed optimal strategies.
Requirements:
- Node.js 22+
- pnpm 11+
- stable Rust toolchain
- the Tauri 2 prerequisites for your operating system
pnpm install
pnpm tauri devCreate a production package with:
pnpm check
pnpm tauri buildmacOS packages must be built on macOS, and Windows packages must be built on Windows. See Development and data maintenance for catalog tooling and the full verification commands.
The bundled catalog is generated from FFXIV Collect and XIVAPI. Simplified Chinese localization is generated from the public game-data exports in ffxiv-datamining-cn. Card artwork is not bundled with the source repository or application package. It is retrieved at runtime from external data services and cached locally when needed.
Only the reviewed localization data is bundled with Triadfolio; the upstream CSV files are not downloaded or accessed while the application is running.
Acquisition links can open Lodestone, Console Games Wiki, Gamer Escape, or Huiji Wiki. These sites are external services and are not bundled with or operated by Triadfolio.
Triadfolio's source code is available under the MIT License. FINAL FANTASY XIV names, game data, trademarks, and third-party site content remain the property of their respective owners.
Triadfolio is an unofficial fan-made project and is not affiliated with or endorsed by Square Enix.
FINAL FANTASY is a registered trademark of Square Enix Holdings Co., Ltd.
FINAL FANTASY XIV © SQUARE ENIX CO., LTD.
