---
title: Сustom firmware
slug: zero/video-game-module/custom-firmware
description: Learn how to install custom firmware on the Video Game Module via Flipper Zero and PC
image: https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/6X6dzaqvA0DLFw4oIO_KT_customfirmwarevideogamemodulepreview.png
docTags: 
createdAt: 2024-01-11T09:27:25.777Z
---

![](https://api.archbee.com/api/optimize/3GUDYkC5JgUWgo6RW8piO-Z2o6cQPghSuZ0UCY8wD0p-20241107-102626.png)

The Video Game Module can be used as a standalone device for applications developed for the RP2040 microcontroller, the same as in Raspberry Pi Pico. On this page, you will learn how to install custom firmware on the Video Game Module via Flipper Zero and PC.

***

# Installing custom firmware via Flipper Zero

The advantage of this method is that you can store multiple versions of module firmware on your Flipper Zero and install them on your Video Game Module as needed without a computer.

:::Iframe{iframeHeight="500" code="<div class=&#x22;info flipper-callout&#x22;>&#xA;    <div class=&#x22;callout-header&#x22;></div>&#xA;     Please note that the custom firmware file for the module must be in the .uf2 format. When creating a custom UF2 firmware image for installation via Flipper Zero, there are some limitations to keep in mind:&#xA;     <ul>&#xA;         <li>- Non-flash blocks are <b>not</b> supported.</li>&#xA;         <li>- Block payloads <b>must</b> be exactly 256 bytes.</li>&#xA;         <li>- Payload target addresses <b>must</b> be 256 byte-aligned with no gaps.</li>&#xA;         <li>- Features such as file containers and extension tags are <b>not</b> supported.</li>&#xA;     </ul>&#xA;</div>"}

:::

In order to install custom firmware on the module, you must first transfer the firmware file to your Flipper Zero and then install it on the module via the Video Game Module Tool.

## Step 1. Transfer the firmware file to Flipper Zero

You can transfer custom firmware files to your Flipper Zero via [qFlipper](https://docs.flipper.net/zero/qflipper):

::::WorkflowBlock
:::WorkflowBlockItem
Connect your Flipper Zero to your computer via a USB-C cable.
:::

:::WorkflowBlockItem
On your computer, open the **qFlipper** application.
:::

:::WorkflowBlockItem
Go to the **File manager** tab, then double-click **SD Card**.
:::

:::WorkflowBlockItem
Right-click the empty space and create a new folder for module firmware.

![](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/cJRRe1a25OlFH4HhI6DGX_image.png)
:::

:::WorkflowBlockItem
Go to the created folder.
:::

:::WorkflowBlockItem
Right-click the empty space and select the **Upload here** option.
*or*
Drag and drop the file to the folder.

![](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/na3WVZiTpuJNuOvZ_P-57_image.png)
:::
::::

## Step 2. Install the firmware on the module

Once the module firmware file is on your Flipper Zero, you’re ready to install it on your Video Game Module by doing the following:

::::WorkflowBlock
:::WorkflowBlockItem
If you don’t have the Video Game Module Tool on your Flipper Zero, [install it](https://docs.flipper.net/zero/video-game-module/firmware-update#8_38o).
:::

:::WorkflowBlockItem
Connect the Video Game Module to your Flipper Zero.
:::

:::WorkflowBlockItem
On your Flipper Zero, go to **Main Menu -> Apps -> Tools -> Video Game Module Tool**.
:::

:::WorkflowBlockItem
In the app, select the **Install Firmware from File** option.
:::

:::WorkflowBlockItem
Select the file with custom firmware.
:::

:::WorkflowBlockItem
Confirm installation by pressing **Install**%right%.
:::

:::WorkflowBlockItem
Once the module firmware is installed, you’ll see a message: **Video Game Module Updated**.

![](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/26N5YzupInqv3ni0on3vC_monosnap-miro-2024-01-23-14-42-08.jpg)
:::
::::

***

# Installing custom firmware via PC

Alternatively, you can install firmware (in the `.uf2` format) on the module directly from your computer. For that, you’ll need to connect the module as a USB Mass Storage device by doing the following:

:::::WorkflowBlock
:::WorkflowBlockItem
**Disconnect the module** from Flipper Zero and the USB-C cable if connected.
:::

:::WorkflowBlockItem
On the module, press and hold the **BOOT** button with a paper clip.
:::

:::WorkflowBlockItem
Connect the module to your computer via a USB-C cable.

![](https://api.archbee.com/api/optimize/3GUDYkC5JgUWgo6RW8piO-vy_fdvYPkhPE2vRrEI_Xu-20241025-133731.png)

The module will switch to USB Mass Storage mode and should automatically mount as a Mass Storage Device (**RPI-RP2**) on your computer.
:::

:::WorkflowBlockItem
Release the **BOOT** button.
:::

::::WorkflowBlockItem
On your computer, in a file manager, drag and drop the UF2 firmware file onto the **RPI-RP2** device.

The module will automatically reboot, unmounting itself as a Mass Storage Device.

:::Iframe{iframeHeight="500" code="<video&#xA;    autoplay muted loop playsinline style=&#x22;width: 100%; margin: 0 !important;&#x22;&#xA;    src=&#x22;https://cdn.flipperzero.one/Monosnap_screencast_2024-01-24_21-27-24.mp4&#x22;&#xA;></video>"}

:::
::::
:::::

