User on Firefly Zero docs

Installation

Mon, 01 Jan 0001 00:00:00 +0000

🐚 CLI#

🐧 Linux

Choose one of the following:

Installation script (recommended)

Run the following command in the terminal and watch the magic happen:

bash -c "$(curl https://fireflyzero.com/install.sh)"

Cargo (Rust package manager)

If you have cargo (the Rust package manager) installed, you can use it to install firefly-cli:

cargo install firefly_cli

After that, open ~/.bashrc (or ~/.zshrc if you use zsh) and add at the end the following:

alias ff="firefly_cli"

Manual

Download the latest release. You need the one containing -linux- in the name. If you don’t know which one you need, it’s probably the one ending with -x86_64-unknown-linux-gnu.tar.gz.

Emulator

Mon, 01 Jan 0001 00:00:00 +0000

The emulator allows you to run any Firefly Zero apps on your computer. To install it, follow the Installation guide.

🕹 Input#

The emulator supports the following input methods, from best to worst.

Firefly Zero device
Steam controller
Gamepad
(⌛ Coming soon) UI buttons
Keyboard

📱 Firefly Zero device#

The device can be used as a gamepad (not only for the emulator). See firefly-gamepad.

💨 Steam controller#

It is discontinued but you may find a used one. It has a touchpad just like Firefly Zero, and that makes it a better fit, compared to Xbox controllers, for apps requiring a precise input.

Settings

Mon, 01 Jan 0001 00:00:00 +0000

You can change device settings in the “System Settings” app.

Navigation:

Press up or down on the touchpad to move the cursor between available options.
Press left or right when the cursor is on the header to switch between tabs.
Press E (Enter on emulator) to activate or change the selected option.

💬 Language#

Select the preferred interface language. This affects all system apps and some games. Translations are a community effort. If your languages is not on the list or some translations are incorrect, you can help us by translating the relevant app.

Multiplayer

Mon, 01 Jan 0001 00:00:00 +0000

To establish a multiplayer connection, take 2 or more devices (or launch 2 or more copies of the emulator) and on each device:

Open the launcher.
Launch “Start multiplayer” (the first app on the list) by pressing E (Enter on the emulator).
Wait for all other devices to appear on the list.
Press E on both devices (in any order) to stop scanning.
Select “confirm” and press E on both devices (in any order) to confirm that the list of devices is complete.

Then on any of the devices select and launch the app you want to play together. That’s it! The app should start on all devices and you all should have control.

Repair

Mon, 01 Jan 0001 00:00:00 +0000

Firefly Zero is a sustainable device and we believe in your right to repair. We want everyone to truly own the things they buy and understand how these things work.

Opening and disassembling Firefly Zero does not void the warranty. However, breaking the device while disassembling (just like other intentional damage) voids the warranty. So, before you get started, make sure you know what you’re doing. And this page is here to guide you.

Hacking

Mon, 01 Jan 0001 00:00:00 +0000

Firefly Zero is one of the first game consoles in the world designed to be hacked. We want you to have fun, and there is nothing more fun than taking things apart and figuring out how everything works. So, let’s hack it!

#

This tutorial covers hacking apps and runtime. To physically take apart the device, see Repair.

Breaking things may break things!

When taking apps apart, it’s possible to break them or damage some data (like game saves). To prevent losing your progress, we’ll be mostly using Firefly Emulator in this tutorial. Before hacking the app on the device, make sure to backup game data. We’ll cover the emulator and backups below.