Skip to content

Instantly share code, notes, and snippets.

@4626k

4626k/flameoceanforkedtutorial.md

Last active February 8, 2026 18:50
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save 4626k/4eec9bd6d8cb259b7ed8c5673340e7d5 to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save 4626k/4eec9bd6d8cb259b7ed8c5673340e7d5 to your computer and use it in GitHub Desktop.
Download ZIP
FlameOcean Fork Tutorial
Raw
flameoceanforkedtutorial.md

FlameOcean Forked Setup Guide

The change is now up on the original website, you dont need to use this tutorial anymore !

I will delete this if the original dev (https://github.com/Losses) decide to merge the PR.

Keep in mind what you are about to do is just running the web app locally since my changes is not push yet to the original website (https://flame-ocean.not.ci/).

Prerequisites

  • Git: Repository management.
  • Bun: JavaScript runtime and package manager.
  • .IMG firmware file from the fiio website. From now on it will be referred to as .bin.

Installation

1. Install Git

  • Windows: Download from git-scm.com.
  • macOS: Run xcode-select --install or brew install git.

2. Install Bun

  • Windows (PowerShell):
irm bun.sh/install.ps1 | iex
  • macOS/Linux:
curl -fsSL https://bun.sh/install | bash

Project Setup

Clone repository

git clone https://github.com/selr1/flame-ocean-website.git
cd flame-ocean-website

Switch branch

git checkout sequence-auto-convert

Install dependencies

bun install

Start development server

bun run dev

Access the interface at http://localhost:5173/.

Usage Instructions

Basic Image Replacement

  • Load: Drag firmware .bin into the browser.
  • View: Use the left resource tree for fonts/images.
  • Replace: Drag new images onto the viewer or use clipboard (Ctrl+V / ⌘+V).

This is what you are looking for :

Batch Animation Replacement (Video to Frames)

  • Select Range: Hold CTRL and click to select a range of sequential images (e.g., Z_POWERON0 through Z_POWERON39 for loading screen).
  • Open Replacer: Use the Sequence Replacer panel.
  • Import Video: Drop an .mp4 file into the panel.
  • Apply: Click Apply to extract frames and map them to the selected indices.
  • Export: Save the modified firmware (Ctrl+S / ⌘+S).
  • Rename the obtained .bin to its original name with .IMG extension.

Troubleshooting

  • Command not found: Restart terminal after installation.
  • Port conflict: Close other processes or use the alternative port assigned by Vite.
  • Blank page: Verify active branch is sequence-auto-convert.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment