Config.txt
Last updated
Was this helpful?
Last updated
Was this helpful?
On Raspberry Pi hardware, the config.txt
file is used to configure boot and hardware configuration, similar to how the BIOS or UEFI are used on an PC.
There are two options for editing config.txt
: over the network using SSH or removing the storage medium (SD card, USB drive) and editing the file directly on your computer.
config.txt
is usually on the /boot
partition in Raspberry Pi OS. In LibreELEC, the /flash
boot partition is read-only by default, so we need to remount it in read-write mode:
We will use the nano
text editor to modify the file. Save changes with ctrl+o
and exit using ctrl+x
:
After editing, set the /flash
partition back to read-only mode:
Finally, reboot for the changes in config.txt
to be applied:
Turn off the Raspberry Pi, remove the SD card on USB drive on which LibreELEC is installed, and use a card reader connected to your Windows, Linux, or macOS computer.
If using Windows, use a text editor capable of saving text files in Unix format, e.g. or Wordpad.exe (not Notepad.exe).
Raspberry Pi 3 hardware has higher spec CPUs and is capable of software-decoding without the licenses, although purchasing them allows hardware-decoding and your device will run cooler.
Raspberry Pi 4 is capable of software decoding these formats and license keys are not available.
To purchase license keys you need the serial number of your Raspberry Pi. This can be read with the following command:
Edit config.txt
as described above, uncommenting the license key lines by removing the #
marks, and replacing 00000000
with the keys you received after purchasing:
Reboot and confirm the license keys are installed correctly by running these commands:
If the licenses are enabled you should see this:
If any key that you purchased shows disabled
check that:
You entered the correct serial number
You added the licence key to config.txt
correctly
You uncommented the lines in config.txt
by removing the \#
mark (and space)
You rebooted before testing
Raspberry Pi kernels use a board-specific device-tree file to describe the board's hardware and how things are connected. As the Raspberry Pi is designed to be extended with extra hardware via HATs and peripheral connectors the kernel also supports device-tree "overlay" files. When configured, these overlay "fragments" of device-tree content that describe the extra hardware on the board device-tree, and the the kernel reads them as a single combined file.
Overlays can be found in /flash/overlays
and they are configured in config.txt
in the root folder of the SD card that you boot the Raspberry Pi from. The following are examples of common overlay changes.
On RPi 5, using Libreelec 12 and upwards, different audio interfaces are needed:
With kernels older than 6.1.77 on RPi 5, "slave" mode must be forced:
Override defaults for the gpio-ir module:
Raspberry Pi 0/1/2 cannot hardware-decode MPEG2/VC-1 media files without a license key that can be purchased from the . The hardware is too slow to software decode these formats without the keys.
Please see for more details on overclocking.