Star 历史趋势
数据来源: GitHub API · 生成自 Stargazers.cn
README.md

FujiMod

This repo contains open source tooling that can help developers access camera internals and work on mods. We’re gathering on the FujiHack.org Discord to collaborate.

The FujiMod firmware modification itself is not yet open source, but we’re working on it!

If you want to help by testing FujiMod firmware on your camera, head to fujimod.com. Due to copyright, we can’t distribute ready-made builds of FujiMod since it’s based on the official firmware. Use the search box on the site to find the download link from Fujifilm for your camera. Then upload it to fujimod.com so we can build the mod for your camera.

Camera tools, emulation and firmware mods. The browser application lives in apps/web, including its body definitions, patch interpreter, runtime adapter and browser checks. The shared emulator UI lives in packages/emulator-ui/.

Use mise install, then work in apps/web:

pnpm install --frozen-lockfile
cd apps/web
pnpm test
pnpm run dev

The root web-build, web-test and web-preview mise tasks run from that application directory. web-test runs both @fujimod/emulator-ui tests and the web app tests through apps/web's pnpm test. The Web deploy workflow deploys main to fujimod.com nightly when it changed, reusing the deployed emulator runtimes and media; a maintainer deploys new runtimes by hand (apps/web/DEPLOYMENT.md). Merging does not deploy.

Rust libraries

The root Cargo workspace contains reusable implementation crates under crates/. The fujimod facade exposes components through optional features; enable usb for fujimod::usb. The mod installation crate provides checked uploads and borrowed callback batches. The USB crate provides the initial asynchronous service/debug protocol implementation. The catalog crates load caller-selected firmware data: the reference catalog through fujimod::catalog, and the service definitions USB uses through fujimod::catalog_service. Enable the emulator feature for fujimod::emulator; execution, device models and processor backends live in separate crates under crates/emulator*. The Python package exposes the same execution core through fujimod.emulator.

External EXR II board composers can consume fujimod_emulator_exr2_boot_serial::BootSerialBlocks::devices() into their device graph. Register each Some(Mapping) window and attach each None entry as an unmapped event device; the returned devices share one serial state and coordinator.

cargo test --workspace --all-features
cargo clippy --workspace --all-targets --all-features -- -D warnings

Every member depends on fujimod-workspace-hack, which cargo-hakari generates so that any package selection builds third-party crates with the same features and reuses one compiled copy. After adding or changing a dependency, run mise run rust-hack (mise install provides cargo-hakari); CI fails when the crate is out of date. fujimod-unicorn-sys compiles the Unicorn C archive with no features, so every feature set, test and binary of the CPU backend shares one archive per profile.

Development uses two profiles: cargo test builds the default debug profile, and every optimized local build (--release, scripts/python_extension.py, the emulator worker) shares release, which rebuilds in seconds: FujiMod crates at opt-level 2 without LTO, incremental, with dependencies fully optimized. --profile release-web adds ThinLTO for the web emulator and web wheels; it runs about 5% faster and links for about 40 seconds longer.

The core also builds for WebUSB. See the USB crate's Wasm checks for the JS-runtime tests; the JavaScript package provides typed browser APIs over the same core. Python in Pyodide uses the WebUSB adapter with that initialized module.

The Python package lives in bindings/python/.

Rust owns each browser USB device for the page's lifetime. Local sessions and remote controllers are both clients of that one nusb owner, with one session ownership lock. The browser end runs the Rust/Wasm exporter; JavaScript only routes its network messages. Sharing attaches or detaches peers independently of the physical connection. See USB sharing.

The JavaScript/Wasm package lives in bindings/javascript/. Binding crates are members of this same workspace. Each directory owns its language package; implementation crates remain independent of PyO3 and wasm-bindgen. The browser application stays in apps/web/ and consumes the JavaScript package as needed.

The shared binding generator derives service value wrappers, command/action factories, structured replies and language exports from Rust declarations. Routine service features need only Rust code; shared adapters handle execution and language boundaries.

Continuous integration

See CI.md for the required checks, local commands, coverage reports and the distinction between public tests and firmware-dependent rehearsals.

License

FujiMod is distributed under the GNU General Public License, version 2. See LICENSE. The emulator runtime links Unicorn Engine, which is GPLv2 as well; the source and modifications we use are in the justjake/unicorn fork at the commit recorded as unicorn_commit in the runtime's build.json.

关于 About

Fujifilm camera modification tools. DO NOT FLASH CUSTOM FIRMWARE TO YOUR CAMERA WITHOUT DUAL BOOTING FIRST
ai-slopemulatorfujifilmusb

语言 Languages

Rust81.8%
TypeScript12.2%
Python4.9%
CSS0.6%
WGSL0.4%
C0.1%
HTML0.0%
Shell0.0%

提交活跃度 Commit Activity

代码提交热力图
过去 52 周的开发活跃度
3481
Total Commits
峰值: 847次/周
Less
More

核心贡献者 Contributors