_____ _ _______ _____
| ___| __ ___ ___| |_ ____ | ____\ \ / / _ \
| |_ | '__/ _ \/ _ \ __|_ /____| _| \ \ / / | | |
| _|| | | __/ __/ |_ / /_____| |___ \ V /| |_| |
|_| |_| \___|\___|\__/___| |_____| \_/ \___/
Freetz-EVO is a fork of Freetz-NG, which remains the technical foundation of this project. Freetz-EVO builds on that foundation with additional packages, UX improvements, and workflow tooling.
Freetz-EVO is easier, sleeker, with more features and less bugs.
Freetz-EVO includes:
- over 120 new packages and libraries, including exclusive applications, Go and Rust support,
- over 70 python3 packages, including Rust support,
- over 70 libraries,
- over 40 improved packages and libraries,
- USB audio stack, extensive playback and recording tools, local playlist management and web radio functions,
- hidapi support for HID-Class USB device access and ja11-config-tui support for configuring FiiO JA11 and other KT02H20 DSP-based USB DACs,
- X11 client libraries and tools,
- microcontroller flasher tools to enable USB peripheral devices.
- built-in Go and Rust toolchains to compile Go and Rust packages.
The extensive Python3 support allows installing and running Home Assistant.
Relevant new packages include rtorrent with improved ruTorrent web tool, aria2 with AriaNg web tool, Gerbera, a Disk Management interactive web tool, ncdu web tool, improved elfinder Web tool, GCC on-device, nginx and many others.
New subsystems also include ALSA userspace audio packages, exposed ALSA/USB audio kernel drivers on compatible targets, and the cdc-acm USB serial driver for native USB CDC ACM devices.
On compatible targets, enabling the exposed ALSA/USB audio drivers together with the ALSA userspace stack allows audio playback through a USB headset or, preferably, a USB HiFi DAC. Combined with the available MPD, mpc, myMPD, and related web interfaces, Freetz-EVO also offers web radio browsing, playback, and control functions directly from the browser.
Additionally, Freetz-EVO offers AI translation for non EN and DE languages, more explicit error/warning messages, an advanced GitHub Action for testing new developments, and many other new features.
Freetz-EVO is continuously kept in sync with the upstream Freetz-NG repository: upstream fixes, new firmware support, and toolchain updates are periodically merged, so Freetz-EVO keeps evolving on top of recent Freetz-NG base.
New to Freetz-EVO? The Getting Started guide walks you through the complete workflow: setting up a Linux build environment (including WSL on Windows), configuring the firmware, building it, and flashing your device.
Note: all new packages are currently developed and tested on an AVM FRITZ!Box 7590 AX with firmware FRITZ!OS 8.25.
Freetz-EVO is still in development.
The Freetz-EVO web interface features a completely redesigned, fully responsive, mobile first skin ("EVO skin"). On mobile devices, the navigation adapts to a fixed bottom bar with a slide-up drawer for sub-menus and sub-pages; on desktop and tablet a horizontal top menu with hover dropdowns is used, with an optional hamburger mode that collapses the top bar into a right-side slide-in panel. Dark mode, page-width toggle, and per-device preferences are persisted in cookies for a consistent experience across page loads and devices.
The web interface can be added to the home screen on any smartphone (Android or iOS) for an app-like experience; on Android, Samsung Internet delivers a full PWA-quality install. With freetz_proxy and HTTPS the full PWA install prompt is available, and the same HTTPS URL works remotely via MyFRITZ! without port-forwarding. See docs/mobile.md for detailed setup instructions.
The authentication layer has been updated to support a form-based session login (in addition to the legacy HTTP Basic Auth mode). When the New login with session id option is enabled, the web interface presents a custom HTML login page instead of the native browser credential dialog; access is protected by a session cookie with a configurable inactivity timeout, persisted across browser restarts, so re-opening the browser within an active session no longer forces re-authentication. A bug in passwd_save.sh that caused the stored password hash to include the username prefix — making any password change break subsequent logins — has been fixed. The session cookie has been hardened: the session ID is now generated from /dev/urandom (128-bit CSPRNG) instead of a predictable MD5 of the login timestamp, and the cookie is issued with HttpOnly (blocks JavaScript access, preventing XSS-based session hijacking) and SameSite=Strict (blocks all cross-site request forgery, including top-level navigation from external links) flags.
Interactive UI Mockup — live preview of the Freetz-EVO web interface (no device needed)
| Package | Description | Status |
|---|---|---|
Disk tools |
Complete storage toolkit centered on the Disk Management Web UI (disk-mgmt-cgi), a web console for partitioning, formatting, cloning, recovery, and disk diagnostics; backed by parted, util-linux, gptfdisk, e2fsprogs, dosfstools, exfatprogs, ntfs-3g, fatresize, partclone, ddrescue, smartmontools, hdparm, testdisk, fsarchiver, clonezilla, and udpcast. |
EVO only |
util-linux |
Dual-version support (2.27.1 / 2.41) with Disk Tools category and utilities like lsblk, fdisk, blkid. |
upstream has 2.27.1; EVO adds 2.41 |
ncdu 1.19 |
NCurses disk usage analyzer for quick inspection of storage usage on mounted filesystems. | EVO only |
ncdu CGI (ncdu-cgi) |
Web frontend for ncdu integrated into the Freetz configuration pages for browser-based usage analysis. | EVO only |
ALSA / USB audio kernel support |
Exposes soundcore, snd, snd-timer, snd-pcm, snd-hwdep, snd-rawmidi, snd-usbmidi-lib, and snd-usb-audio in menuconfig on compatible targets. |
EVO only |
alsa-utils 1.2.13 / alsa-lib 1.2.13 |
ALSA userspace toolchain and runtime library for playback, capture, mixer control, MIDI/sequencer tools, and /usr/share/alsa configuration data; both support external deployment. |
EVO only |
alsaequal 0.7.1 |
ALSA equalizer bridge exposing LADSPA EQ plugins as standard ALSA PCM/control devices; optional Freetz config/status web UI via alsaequal-cgi. |
EVO only |
alsa-plugins 1.2.12 |
ALSA output and rate conversion plugins (samplerate, speexrate, lavrate) for extending PCM capability | EVO only |
caps-ladspa 1.0 |
CAPS LADSPA plugin suite: amplifiers, equalizers, delays, reverbs, and modulation audio effects | EVO only |
cmus 2.11.0 |
Ncurses music player with ALSA output and MP3/FLAC/Vorbis playback. | EVO only |
go-librespot 0.7.1 |
Spotify Connect audio daemon cross-compiled from upstream Go sources with CGO, using ALSA output plus FLAC and Ogg/Vorbis support; optional Freetz config/status web UI via go-librespot-cgi. |
EVO only |
ncspot 1.3.4 |
Terminal Spotify client built from upstream Rust sources with ALSA playback and crossterm UI backend, packaged for target-side interactive use. | EVO only |
MPD 0.24.13 |
Music Player Daemon with local database, TCP control interface, UNIX socket, ALSA output, and MP3/FLAC/Vorbis decoding; optional Freetz config/status web UI via mpd-cgi. |
EVO only |
libmpdclient 2.22 |
Official MPD client library packaged as a shared runtime for target-side MPD frontends; includes Freetz defaults for localhost, port 6600, and /var/run/mpd/socket. |
EVO only |
mpc 0.35 (mpd-mpc) |
Minimal MPD command-line client using shared libmpdclient; suitable for shell scripts, SSH sessions, and queue/player control against local or remote MPD servers. |
EVO only |
myMPD 25.0.2 |
Standalone lightweight web-based MPD client with embedded web assets and embedded libmpdclient; optional Freetz config/status web UI via mympd-cgi. |
EVO only |
ncmpc 0.52 |
Official ncurses client for MPD with library browser, playlist editor, search, lyrics screen, key bindings help, output configuration, and mouse support; optional iconv, LIRC, NLS, and PCRE2 regex support. | EVO only |
ncmpcpp 0.10.1 |
Feature-rich ncurses MPD client with tag editor, media library, playlist management, search, clock, outputs screen, visualizer, and Boost-backed configuration parsing; depends on libmpdclient, ncursesw, curl, taglib. |
EVO only |
rmpc 0.11.0 |
Beautiful, configurable TUI client for MPD written in Rust with album art, lyrics, and playlist management; built from upstream Rust sources via cross-compiled Cargo. | EVO only |
shairport-sync 5.0.4 |
AirPlay receiver with ALSA output, metadata FIFO processing, and a Freetz config/status web UI. | EVO only |
snapcast 0.35.0 |
Multiroom audio server/client package with snapserver, snapclient, ALSA output, and FLAC/Ogg/Vorbis support. |
EVO only |
SoX 14.4.2 |
Sound eXchange — command-line audio converter, player, and recorder with multi-format and effect support | EVO only |
Gerbera 3.2.1 |
UPnP/DLNA media server with content directory, transcoding, and metadata extraction; includes CGI web config editor with ACE editor and setup wizard | EVO only |
miniupnpd 2.3.10 |
Lightweight UPnP-IGD daemon for automatic port forwarding via UPnP | EVO only |
btop 1.4.7 |
Modern terminal resource monitor for CPU, memory, disks, network, and processes, with optional upstream themes. | EVO only |
nmon 16s |
Curses-based Linux performance monitor for CPU, memory, disks, network, filesystems, and processes, with optional capture-to-file mode for later analysis. | EVO only |
wavemon 0.9.7 |
Ncurses wireless monitor for signal quality, bitrate, channels, and interface statistics. | EVO only |
cdc-acm kernel driver |
Exposes cdc-acm.ko in menuconfig on compatible targets, enabling native USB CDC ACM serial devices such as ESP32-C3 boards and other USB serial gadgets. |
EVO only |
avrdude 8.1 |
AVR downloader/uploader toolchain with avrdude, elf2tag, and default /etc/avrdude.conf for full AVR flash/program workflows. |
EVO only |
esp-serial-flasher git-f1cccac |
ESP serial flashing toolkit shipping linux_flasher and esp_fw_upload for multi-image ESP32-family firmware upload layouts. |
EVO only |
micronucleus 2.6 |
USB bootloader uploader for Digispark/ATTiny devices using Micronucleus (/usr/bin/micronucleus). |
EVO only |
telink_tools 1.0 |
Native C Telink BLE bootloader CLI for TB-03F-KIT/TB-04-KIT style devices; supports burn, triad programming, and flash read/write/erase operations. | EVO only |
ja11-config-tui 1.0 |
TUI configurator for FiiO JA11 and other KT02H20 DSP-based USB DACs; 5-band parametric EQ, DAC digital filters, global preamp gain, preset management, persistent flash save, and i18n (EN/IT). | EVO only |
lazygit 0.61.1 |
Full-screen terminal UI for Git repositories. | EVO only |
neovim 0.12.2 |
Modern terminal-based text editor, fork of Vim with Lua scripting, built-in LSP client, and tree-sitter syntax highlighting; cross-compiled with CMake and Ninja | EVO only |
lf r41 |
Terminal file manager with a Miller-column layout, keyboard-driven navigation, and customizable key bindings. Built with Go cross-compilation. | EVO only |
age 1.3.1 |
Modern file encryption tool. | EVO only |
caddy 2.11.2 |
General-purpose web server and reverse proxy with automatic HTTPS capabilities. | EVO only |
fzf 0.72.0 |
Command-line fuzzy finder for interactive shell filtering. | EVO only |
ripgrep 15.1.0 |
Ultra-fast text search tool built from Rust sources with cross-compilation support; recursively searches file contents with grep-compatible patterns | EVO only |
glow 2.1.2 |
Terminal Markdown renderer for browsing README files and notes. | EVO only |
gum 0.17.0 |
Terminal UI helper toolkit for shell scripts. | EVO only |
hey 0.1.5 |
Small HTTP load generator for smoke tests and benchmarks. | EVO only |
hugo 0.161.1 |
Static site generator for content trees stored on writable media. | EVO only |
prometheus 3.11.3 |
Monitoring and alerting server with local TSDB storage. | EVO only |
rclone 1.74.1 |
Cloud and remote storage synchronization tool. | EVO only |
bat 0.26.1 |
Syntax-highlighting cat replacement for reading config files, logs, and source files directly on the device. |
EVO only |
bottom 0.12.3 |
Terminal system monitor (btm) for CPU, memory, disk, network, and process metrics. |
EVO only |
bandwhich 0.23.1 |
Terminal bandwidth utilization monitor by process/connection. | EVO only |
procs 0.14.11 |
Modern process viewer as an enhanced alternative to ps. |
EVO only |
broot 1.56.4 |
Tree-style terminal file browser and launcher. | EVO only |
eza 0.23.4 |
Modern ls replacement with richer directory listings, colors, and tree-style output. |
EVO only |
gitui 0.28.1 |
Terminal UI for interactive Git workflows. | EVO only |
jless 0.9.0 |
JSON pager/reader with interactive navigation and search. | EVO only |
lnav-rs 0.9.0 |
Rust-based log/JSON pager package (alias build based on jless). |
EVO only |
lnav 0.14.0 |
Advanced terminal log viewer and analyzer with optional Rust/PRQL extensions exposed in menuconfig and support for external deployment. | EVO only |
sha256sum 0.9.0 |
SHA-256 checksum utility packaged from uutils/coreutils for target-side integrity verification. | EVO only |
tac 0.9.0 |
Reverse concatenation utility packaged from uutils/coreutils for target-side text processing workflows. | EVO only |
termscp 1.0.0 |
Terminal SCP/SFTP client and remote file browser. | EVO only |
rainfrog 0.3.18 |
Terminal database explorer and query tool for SQLite (via sqlx), built from Rust sources |
EVO only |
atuin 18.16.1 |
Shell history synchronization and improved history search utility. | EVO only |
oxker 0.13.2 |
Terminal Docker container monitor/manager UI. | EVO only |
yazi 26.5.6 |
Fast terminal file manager package shipping yazi and helper ya. |
EVO only |
zoxide 0.9.9 |
Smarter directory-jump helper that complements interactive shells with ranked path lookup. | EVO only |
restic 0.18.1 |
Encrypted backup tool for local and remote repositories. | EVO only |
vhs 0.11.0 |
Scripted terminal-session recorder for demo generation. | EVO only |
NeoMutt 20260504 |
Console email client (MUA) with IMAP/POP3/SMTP, SSL/TLS via OpenSSL, wide-character ncurses UI, threading, sidebar, and a rich muttrc scripting language. |
EVO only |
yq 4.53.2 |
YAML, JSON, and XML processor for config automation. | EVO only |
ttyd 1.7.7 |
Web-based terminal server: exposes any shell command over WebSocket; CGI page embeds a full xterm.js terminal with 7 themes, fullscreen, search, font-size controls, and canvas renderer. | EVO only |
aria2 / AriaNg |
Multi-protocol download utility (HTTP, FTP, BitTorrent, Metalink) with a full web UI (AriaNg) and CGI integration. | EVO only |
rTorrent 0.16.7 / ruTorrent 5.2.10 |
Feature-rich BitTorrent client with a complete web interface, CGI backend, and config editor. | EVO only |
aMUTorrent 3.5.0 |
Experimental torrent client with full Node.js backend and Express/WebSocket frontend. Bootstrap preconfigures local rTorrent via SCGI. DEVELOPER only. | EVO only |
transmission |
Added integrated static frontend selectors in the Transmission submenu (flood-for-transmission 1.0.1, TrguiNG web 1.5.1, Transmissionic web UI 1.8.0, transmission-web-control commit snapshot), with package-level installation under /usr/mww/*; all available as selectable static frontends integrated in the Transmission package menu. |
EVO only |
transmission-flood 1.0.1 |
Flood web frontend for Transmission, a modern responsive UI packaged as a selectable static frontend under /usr/mww/transmission/ |
EVO only |
TrguiNG web 1.5.1 |
TrguiNG web frontend for Transmission, a modern Angular-based UI packaged as a selectable static frontend under /usr/mww/transmission/ |
EVO only |
freetz_proxy |
Lightweight CGI HTTPS↔HTTP reverse proxy and index gateway, with HTML/CSS/JS URL rewriting and CDN proxying. Accessible via MyFRITZ! and from the internet without port-forwarding. When included, the Fritz logo and the AVM user menu gain direct links to the Freetz menus (through the proxy). | EVO only |
melcloud |
MELCloud integration package with daemon, init script, CGI endpoint, and web UI for Mitsubishi Electric devices. | EVO only |
Nginx 1.29 |
High-performance HTTP/reverse-proxy server with MIPS/ARM cross-compilation fixes and optional externalization. | EVO only |
krb5 |
MIT Kerberos/GSSAPI runtime libraries (libkrb5, libgssapi_krb5) for target packages requiring Kerberos authentication features. |
EVO only |
OpenLDAP 2.6.8 |
Client-library package exporting liblber and libldap for target-side LDAP consumers; server-side slapd pieces are intentionally not built. |
EVO only |
PostgreSQL 16.3 |
PostgreSQL package exporting libpq for target-side SQL consumers and optionally installing minimal server binaries (postgres, pg_ctl, initdb). |
EVO only |
pdns-authoritative 5.0.5 |
PowerDNS Authoritative Server port with optional pdnsutil, pdns_control, zone2sql, zone2json, ixfrdist, diagnostic tools, externalization support, selectable OpenSSL/GnuTLS DNS-over-TLS, optional libsodium and remote ZeroMQ support, and selectable bind/pipe/godbc/gmysql/gpgsql/gsqlite3/geoip/lmdb/lua2/remote/tinydns backends. Requires modern targets because upstream PowerDNS 5 needs GCC 8+ / C++17. |
EVO only |
pdns-dnsdist 1.9.7 |
DNS load-balancer/front-end from the PowerDNS suite, useful for policy routing, load balancing, and DNS traffic filtering. | EVO only |
pdns-recursor 5.3.4 |
Recursive DNS resolver daemon from the PowerDNS suite, packaged separately from authoritative and dnsdist components. | EVO only |
unixODBC 2.3.12 |
ODBC driver-manager library package exporting libodbc, libodbcinst, and libodbccr for target-side database consumers such as PowerDNS godbc. |
EVO only |
PHP 8.4 / 8.5 |
Modern PHP interpreter with multi-version selection (5.6 legacy, 8.4, 8.5), bzip2, libxml2, libatomic support. | upstream has PHP 5.6 only |
QuickJS (2026-03-23 git snapshot) |
Lightweight embeddable JavaScript engine, packaged with qjs and optional qjsc compiler support. |
EVO only |
Python 3.14 |
Python 3.14.3 with zip-importer fix, patchelf RPATH support, and build scripts for external deployment. | upstream has 3.14 too |
MicroPython 1.27.0 |
Lightweight Python implementation for constrained environments, including REPL, script execution, and optional micropython-lib modules. | EVO only |
python3-cryptography 48.0.0 |
Python cryptography package with OpenSSL bindings and Rust-backed components, built for target using cross-compiled Rust/Cargo support. | EVO only |
python3-ulid-transform 2.2.9 |
ULID creation/transformation module built via pyproject/pip with Rust/Cargo cross-build support. | EVO only |
python3-uv 0.11.16 |
Rust-based Python package/project manager built via pyproject/pip (maturin) with Rust/Cargo cross-build target support. |
EVO only |
python3-* (64 modules) |
New Python 3 third-party packages: aiodns 4.0.0, aiohttp 3.13.3, aiohttp-asyncmdnsresolver 0.1.1, aiohttp-fast-zlib 0.3.0, aiohappyeyeballs 2.6.1, aiosignal 1.4.0, annotatedyaml 1.0.2, async-timeout 5.0.1, attrs 26.1.0, av 16.0.1, audioop-lts 0.2.1, bcrypt 3.2.2, brotli 1.2.0, cffi 1.17.1, charset-normalizer 3.4.6, ciso8601 2.3.3, dateutil 2.9.0.post0, dbus-fast 4.0.0, faust-cchardet 2.1.19, fnv-hash-fast 1.6.0, fnvhash 0.2.1, frozenlist 1.8.0, grpcio 1.78.0, grpcio-reflection 1.78.1, grpcio-status 1.78.1, h11 0.16.0, ha-ffmpeg 3.2.2, httpcore 1.0.9, httpx 0.28.1, idna 3.11, lru-dict 1.4.1, lxml 6.0.2, markupsafe 3.0.3, multidict 6.7.1, numpy 2.4.3, pandas 3.0.1, pillow 12.1.1, pip 26.0.1, propcache 0.4.1, psutil 7.2.2, pycares 5.0.1, pycparser 3.0, pycryptodome 3.23.0, pymicro-vad 2.0.1, pynacl 1.6.2, pyspeex-noise 2.0.0, pyturbojpeg 2.2.0, pyyaml 6.0.3, setuptools 82.0.1, six 1.17.0, voluptuous 0.16.0, webrtc-models 0.3.0, yarl 1.23.0, zeroconf 0.148.0, python3-bluetooth-data-tools 1.29.18, python3-cached-ipaddress 1.1.2, python3-certifi 2025.10.5, python3-habluetooth 6.8.3, python3-ifaddr 0.2.0, python3-mashumaro 3.17, python3-orjson 3.10.7, python3-pyqrcode 1.2.1, python3-pyric 0.1.6.3, python3-regex 2026.5.9, typing_extensions 4.15.0. Of which, pure-Python runtime modules (no compiled extensions) are: aiohappyeyeballs, aiosignal, async-timeout, attrs, charset-normalizer, dateutil, fnvhash, h11, idna, pycparser, six, voluptuous, certifi, ifaddr, mashumaro, typing_extensions. Build-time tooling (not required at runtime): pip, setuptools. |
EVO only |
GitHub CLI (gh) 2.83.2 |
GitHub CLI tool with Go host-tool integration, allowing GitHub API interaction from the FritzBox. | EVO only |
GNU ddrescue 1.30 |
Resilient data recovery and block-copy utility with mapfile-based resume support. | EVO only |
exfatprogs 1.3.2 |
User-space exFAT utilities for formatting, checking, labeling, and tuning exFAT filesystems. | EVO only |
f2fs-tools 1.9.0 |
Flash-Friendly File System utilities: mkfs.f2fs, fsck.f2fs, dump.f2fs for managing F2FS filesystems |
EVO only |
fatresize (snapshot) |
FAT16/FAT32 resize utility for non-destructive partition resizing tasks. | EVO only |
fsarchiver 0.8.9 |
Filesystem-level backup and restore archiver with compressed image support. | EVO only |
partclone 0.3.31 |
Block-level partition backup/restore/check tools frequently used in cloning workflows. | EVO only |
testdisk 7.2 |
Partition and file recovery toolkit for damaged media and lost partition tables. | EVO only |
udpcast 20250223 |
Multicast transfer utility for one-to-many image distribution in cloning operations. | EVO only |
elFinder 2.1.66 |
Full-featured web-based file manager for the FritzBox with enhancements: drag-and-drop UI, PHP connector (squashfs-safe), FTP remote volumes, video preview (with complete seek back and limited seek forward features), Movie plugin (scaping metadata from TMDb, OMDb, IMDb, Wikipedia; specific for Freetz-EVO), MediaInfo plugin (specific for Freetz-EVO), VLC plugin (specific for Freetz-EVO), unrar/7-Zip support, optional themes with theme selection plugin (specific for Freetz-EVO), multilingual (de/en/it/…), better status bar (specific for Freetz-EVO). | EVO only |
MediaInfo / libmediainfo / libzen / libxmlrpc |
Media file analysis tool with full library stack; reports codecs, bitrates, resolution, and metadata. | EVO only |
proc-ps |
Improved ps replacement backed by procps-ng with richer process information output. |
merged upstream |
cpulimit 0.2 |
Limits the CPU usage of a process to a given percentage; prevents runaway processes from overloading the device. | package improvement |
microperl 5.38 |
Minimal Perl 5.38.2 interpreter (alongside legacy 5.10.1) with full stub library set for embedded use. | upstream has 5.10.1; EVO adds 5.38.2 |
zip 3.0 (infozip) |
Standard zip archiver for creating ZIP archives directly on the device. |
merged upstream |
gdb 17.1 |
GNU Debugger version 17.1 for on-device debugging of binaries and crash analysis. | EVO only for 17.1 (upstream has 6.8/7.9.1) |
valgrind 3.27.0 |
Dynamic analysis framework for memory debugging, leak detection, and profiling; requires kernel 3.x+ | EVO only |
patchelf (target) |
ELF binary patcher for fixing RPATH and dynamic linker paths on cross-compiled binaries. | merged upstream |
binutils-tools (c++filt, elfedit, nm, objdump) |
Additional binutils utilities for binary inspection and symbol demangling on the device. | merged upstream |
autotools 2.72 |
GNU Autoconf, Automake, and Libtool on-device for building configure-based source packages directly on the target. DEVELOPER only. | EVO only |
libnettle |
Low-level cryptographic library (AES, SHA, RSA) used by GnuTLS and other packages. | upstream has nettle |
libzen |
Helper library required by MediaInfo for portable C++ utilities. | EVO only |
libxmlrpc |
XML-RPC library for rTorrent's SCGI/RPC interface; host tool gennmtab moved to make/host-tools. |
EVO only |
libwebsockets 4.3.9 |
Canonical C WebSocket library; optional SSL/TLS support via OpenSSL. | EVO only |
json-c 0.17 |
Lightweight JSON parser/serialiser library. | EVO only |
libcares (c-ares) |
Asynchronous DNS resolver library used by aria2 and curl. | EVO only |
libsodium 1.0.20 |
Modern cryptographic library exporting libsodium for Ed25519 signatures, authenticated encryption, keyed hashes, and other high-level primitives. |
EVO only |
libnl 3.11.0 |
Netlink userspace library stack (libnl-3, libnl-cli-3, libnl-genl-3, libnl-nf-3, libnl-route-3). |
EVO only |
libzmq 4.3.5 |
ZeroMQ messaging library exporting libzmq for asynchronous request/reply, pub/sub, and brokerless messaging patterns. |
EVO only |
libjemalloc 5.3.0 |
General-purpose allocator replacing uClibc malloc; required by aria2 to avoid SIGFPE on MIPS/uClibc-1.0.57. | EVO only |
LMDB 0.9.33 |
Lightning Memory-Mapped Database shared library (liblmdb) for compact embedded key/value storage without a separate daemon. |
EVO only |
libtcmalloc_minimal (gperftools) |
Thread-caching allocator from gperftools; low-overhead alternative to the system allocator. | EVO only |
libprofiler (gperftools) |
CPU profiler from gperftools; co-installed with libtcmalloc_minimal. | EVO only |
libssl (OpenSSL) |
OpenSSL SSL/TLS library; legacy provider module legacy.so added for OpenSSL 3.x compatibility (deprecated algorithms via provider API). |
EVO only |
hidapi 0.15.0 |
Multi-platform HID library (libhidapi-hidraw.so) using the Linux kernel's hidraw interface; enables applications to interface with HID-Class USB devices without libusb. Used by ja11-config-tui. |
EVO only |
lame 3.100 |
High-quality MPEG Audio Layer 3 (MP3) encoding library (libmp3lame.so); provides the LAME encoder for audio applications needing MP3 output. |
EVO only |
libixml 11.1.7 |
Lightweight XML parser library (libixml.so) distributed as part of the Portable UPnP SDK (libupnp); used by Gerbera and other UPnP applications for XML parsing. |
EVO only |
lirc 0.10.2 |
LIRC (Linux Infrared Remote Control) client library (liblirc_client.so); provides infrared remote control support for applications like ncmpc. |
EVO only |
openlibm |
Portable standalone C math library (libopenlibm.so) for consistent libm behavior across platforms and toolchains. |
EVO only |
tinycdb 0.81 |
Compact constant-database library exporting libcdb for read-mostly key/value lookups and TinyDNS-style consumers. |
EVO only |
tflite-micro (TFLM) 20260318 |
TensorFlow Lite for Microcontrollers: static library (libtflm.a) for on-device ML inference. Builds the full TFLM kernel set (conv2d, depthwise conv, LSTM, softmax, fully connected, etc.) from the official flat-source-tree generator. |
EVO only |
llama.cpp b8575 |
CPU-only LLM inference engine for running quantized GGUF language models on-device (no GPU). Includes llama-cli (interactive inference), llama-server (OpenAI-compatible REST API on port 8080), llama-quantize (model quantization), and optional tools (llama-bench, llama-perplexity, llama-tokenize, llama-imatrix, llama-gguf-split, llama-tts, llama-mtmd-cli). Models stored on USB/NAS storage. Shared libraries (libllama.so, libggml*.so). |
EVO only |
yaml-cpp 0.8.0 |
C++ YAML parser/emitter library exporting libyaml-cpp for configuration-driven C++ packages such as PowerDNS geoip and ixfrdist. |
EVO only |
**Gerbera dependency libraries |
Library stack for the Gerbera UPnP media server, including libupnp 1.14.31 (Portable UPnP SDK), libnpupnp 6.3.0 (new-gen UPnP), pugixml 1.16 (XML processing), spdlog 1.17.0 (logging), libfmt 12.2.0 (C++ formatting), icu 76.1 (Unicode), exiv2 0.28.8 (image metadata), libebml 1.4.5 / libmatroska 1.7.1 (MKV container), libffmpegthumbnailer 2.2.3 (video thumbnails), libmagic 5.47 (file type detection), libmicrohttpd 0.9.77 (embedded HTTP server), and xmlrpc 1.64.03 (XML-RPC). All support externalization. |
EVO only |
**Audio libraries |
Audio codec and processing libraries: mpg123 1.32.10 (MP3 decoder), faad2 2.11.1 (AAC decoder), shine 3.1.1 (fixed-point MP3 encoder), tremor (fixed-point Vorbis decoder), libtheora 1.1.1 (Theora video), libsndfile 1.2.2 (audio file I/O), libsamplerate 0.2.2 (sample rate conversion), soxr 0.1.3 (high-quality resampler), libwavpack 5.7.0 (WavPack compression), libshout 2.4.6 (Icecast streaming), libwildmidi 0.4.6 (MIDI playback), fluidsynth 2.3.5 (SoundFont MIDI synthesizer). All support externalization. |
EVO only |
**Data and utility libraries |
Additional data handling and utility libraries: libarchive 3.8.2 (multi-format archive), duktape 2.6.0 (embeddable JS engine), jsoncpp 1.9.8 (JSON), libunistring 1.4 (Unicode strings), libnfs 5.0.3 (NFSv2/v3/v4 client), jemalloc 5.3.0 (general-purpose allocator), libaria2 (download library, external-only), liblastfm 1.0.9 (Last.fm client), caps 0.9.26 (C++ thread-safe containers). All support externalization. |
EVO only |
X11 graphics libraries |
X11 client libraries providing protocol support for remote display via DISPLAY=<host>:<screen>. Includes: libXau (authorisation), libxcb (XCB protocol), libX11 (core protocol), libXext (extensions), libICE (inter-client exchange), libSM (session management), libXt (intrinsics), libXmu (misc utilities), libXaw (Athena widgets, depends on libXpm), libXpm (pixmap), libXfixes (fixes extension), libXi (input extension), and header-only packages xorgproto, xcb-proto, xtrans, util-macros. Required for Python tkinter and X11 applications. |
EVO only |
Tcl/Tk 8.6.16 |
Tcl scripting library and Tk GUI toolkit, providing libtcl8.6.so and libtk8.6.so. Required by Python's tkinter module for building GUI applications displayed on a remote X11 server via DISPLAY=<host>:<screen>. Optional wish shell included with the Tk package for interactive Tk sessions (DISPLAY=<host>:0 wish). |
EVO only |
wish 1.0 |
Symbolic link wrapper for Tk's wish interpreter at /usr/bin/wish |
EVO only |
xclock 1.1.1 |
X11 clock application displaying an analog or digital clock on a remote display via DISPLAY=<host>:<screen>. |
EVO only |
xeyes 1.3.1 |
X11 eyes application: a pair of eyes follow the mouse cursor on a remote display via DISPLAY=<host>:<screen>. |
EVO only |
xterm 410 |
X11 terminal emulator providing a remote terminal window via DISPLAY=<host>:<screen>. Includes the resize utility for terminal size negotiation. |
EVO only |
For a full description of freetz_proxy, see docs/make/freetz-proxy.md.
Added python-pip for python2. All 13 python-* cross-compilation modules (python-bjoern, python-cffi, python-cheetah,
python-pycurl, python-pycryptodome, python-pyopenssl, etc.) were broken during cross-compilation
due to missing environment variables. Freetz-EVO fixes python-module-macros.mk.in by properly
setting CC, CXX, LDSHARED, CFLAGS, PYTHONPATH, and build_ext --library-dirs to point
to the target staging directory instead of the host.
| Package | Enhancement |
|---|---|
| curl | Added CA-bundle toggle option; rTorrent uses the curl CA bundle for HTTPS validation. |
busybox (httpd) |
Added support for HTTP Range header handling for CGI responses, enabling partial-content workflows with CGI-backed endpoints. |
| pcre | Fixed parallel install race condition; removed stray dev/test files; fixed double-indirection via $(PKG) causing stray root symlinks; JIT disabled for kernel 2.6.39.3. |
| pcre2 / libpcre2-posix | Added select FREETZ_LIB_libpcre2_posix to FREETZ_LIB_libpcre2 (posix wrapper is always built alongside pcre2-8); EXTERNAL_FREETZ_LIB_libpcre2_posix changed to default y so libpcre2-posix.so.3.0.7 is automatically externalized. |
| libyaml | Fixed broken find "$FILESYSTEM_MOD_DIR/..." pattern in external.files (replaced with ${FREETZ_LIBRARY_DIR}/libyaml-0.so.2.0.9, matching the working pcre2 approach); EXTERNAL_FREETZ_LIB_libyaml changed to default y so it is auto-enabled when libyaml is selected. |
| iptables | Fixed missing $ in external.files for VERSION_KERNEL4 conditions, preventing broken externalization. |
| ffmpeg | Fixed missing $ in external.files for VERSION_ABANDON condition, preventing broken externalization. |
| fwmod | Augmented Module.symvers with inter-module CRC symbols before the depmod check; pre-existing AVM inter-module symbol version disagreements are now ignored to avoid false build failures. |
| p7zip | Uses FREETZ_RPATH for correct library path at runtime (merged upstream as PR #1433). |
| socat | Fixed posix_memalign for old uClibc; added VSOCK compatibility for kernels < 4.8 (merged upstream). |
| bzip2 | Library porting for PHP dependency chain (merged upstream). |
| sqlite | Disabled math functions for uClibc 0.9.28/29 compatibility (merged upstream as PR #1346). |
| iconv / libiconv | Forced ABANDON version for uClibc 0.9.28 compatibility. |
| unrar | Variable naming fix and version bump (merged upstream as PR #1384). |
| patchelf | Synced host and target tools; used for RPATH fixing in Python and GCC toolchain. |
| binutils | Fixed RPATH; disabled for armeb; c++filt / elfedit added (merged upstream). |
| ldd | Bumped to version matching current uClibc toolchain (merged upstream). |
| RRDTool | aarch64 support; no border fix for v1.2; no v1.2 without libart_lgpl (merged upstream). |
| libatomic | Externalization with dynamic versioning for PHP dependency (merged upstream). |
| PSL (libpsl) | Uses crosscompiling Python tool instead of host Python. |
| glib2 | Meson cross-build fixes: normalized cross-file tool keys and forced host Python for Meson internal generators to avoid target python3 execution. |
| Feature | Description |
|---|---|
| make_package workflow | Advanced GitHub Actions workflow for per-package build testing with matrix parallelism and detailed failure diagnostics. |
| sync-upstream workflow | Automated workflow to merge upstream Freetz-NG changes into Freetz-EVO on a schedule. |
| AI translation | Automatic translation of web UI labels to foreign languages via LLM, with curated override cache. |
| ssh_firmware_update.py | Python tool to flash a Freetz firmware image to a FRITZ!Box over SSH/SCP, emulating the web update process with interactive/batch modes, progress bars, dry-run and debug options. Merged upstream. |
| sync-upstream-manual.sh | Interactive script to merge upstream Freetz-NG changes into Freetz-EVO on demand, with --dry-run, --diff, and --log modes. See docs/SYNC_UPSTREAM.md. |
- After flashing the formware, a web interface will be started on port :81, credentials:
admin/freetz - Default credentials for shell/ssh/telnet access are:
root/freetz - For more see: ircama.github.io/freetz-evo
- You need an up to date Linux System with some prerequisites.
- Or download a ready-to-use VM like Gismotro's Freetz-Linux (user & pass:
freetz). To update it to Freetz-EVO, run again the installation of the prerequisites after cloning this repository. - There are also Docker images available like pfichtner-freetz (README). To update it to Freetz-EVO, run again the installation of the prerequisites after cloning this repository.
git clone https://github.com/Ircama/freetz-evo ~/freetz-evoOr clone a single tag:
git clone https://github.com/Ircama/freetz-evo ~/freetz-evo --single-branch --branch TAGNAME cd ~/freetz-evo
tools/prerequisites install -y cd ~/freetz-evo
make menuconfig # Configure your setup
make # Long-running operation
# make helpAfter running make menuconfig, select the options appropriate for your target device and desired packages, then save the configuration when prompted. The selected configuration will be written to .config. If .config does not exist, it is created, otherwise it is updated.
cd ~/freetz-evo
tools/push_firmware -h cd ~/freetz-evo
tools/ssh_firmware_update.py --host <myIP> --password <myPassword> --batch git status
git diff --no-prefix # --cached # > file.patch
git log --graph # --onelineThe repository contains both version-controlled files and generated build artifacts.
Main directories:
| Directory | Purpose | Can be safely deleted |
|---|---|---|
dl/ |
Downloaded source archives, toolchains and firmware images. Keeping this directory avoids downloading the same files again during subsequent builds. | Yes. It will be recreated automatically, but the next build will need to download all required files again. |
source/ |
Extracted source trees for the kernel, packages and host tools. These are recreated from the archives stored in dl/. |
Yes. They will be recreated automatically during the next build. |
packages/ |
Intermediate package build directories and generated package files. | Yes. They will be recreated automatically. |
kernel/ |
Linux kernel build directory, including generated objects and intermediate files. | Yes. It will be recreated automatically. |
build/ |
Temporary firmware build tree used while assembling the final image. | Yes. It will be recreated automatically. |
toolchain/ |
Generated cross-compilation toolchain and host tools. Rebuilding this directory takes the longest time. | Yes. It will be recreated automatically, although rebuilding it can take a significant amount of time. |
images/ |
Generated firmware images and related output files. Each build creates a new image and updates the latest.image symbolic link to point to the most recent one. Previously generated images are preserved until removed manually or by make distclean. |
Yes. New images will be generated by the next successful build. |
.config |
Build configuration generated by make menuconfig. It contains all selected options for the target device and packages. |
No. Deleting it resets the build configuration. A new .config must be manually created with make menuconfig (or restored from a backup). |
To rebuild everything while keeping your configuration (.config) and downloaded sources (dl/):
make distclean
makeThis removes all generated build artifacts, including the images and the toolchain, but preserves .config and the download cache.
make dirclean
makeThis removes the build directories and extracted sources while keeping the existing toolchain, resulting in a much faster rebuild. Also the images directory is preserved; notice that this directory can grow indefinitely as firmware images and their corresponding backup files are accumulated with each successful build. When running make multiple times, periodically check and manually clean the images/ directory to prevent your build environment from running out of disk space.
To completely restore the repository to the current remote revision and remove all untracked files:
git checkout master ; git fetch --all --prune ; git reset --hard origin/HEAD ; git clean -fdWarning: this permanently discards:
- local commits;
- modifications to tracked files;
- untracked files and directories.
Use this command only when you want to reset the Git working tree. It is not required for performing a clean rebuild.
git pull git checkout HASH-OF-COMMIT # -b NEW-BRANCH git checkout EXISTING-BRANCHSee https://ircama.github.io/freetz-evo/ (or docs/).
cd ~/freetz-evo
tools/zensical_httpserver.shLanguage: This repository uses English as its primary language for code, documentation, commit messages, and issues.
This repository contains two distinct components under different licences:
-
Freetz-NG base (all content inherited from the upstream Freetz-NG project) is licensed under the GNU General Public License v2.0 (GPL-2.0). See COPYING for the full GPL-2.0 text.
-
Freetz-EVO extensions (all new packages introduced by this fork, not available upstream) are licensed under the European Union Public Licence v1.2 (EUPL-1.2). See LICENSE for the full EUPL-1.2 text.
-
Reuse of Freetz-EVO-original files: when files that are original to Freetz-EVO (e.g., package makefiles or other code not derived from upstream Freetz-NG) are reused in other projects, including upstream, their licence remains EUPL-1.2. Reusers should keep the original copyright/licence notices and clearly indicate that those specific files are under EUPL-1.2.