File Browser for Kindle (KUAL Fork)

This repository is a Kindle-focused fork of filebrowser with:

• Kindle ARM builds (hf and sf)
• KUAL extension layout (filebrowser-kual/)
• one-command packaging flow (scripts/package-kual.sh)

Quick Start

Build and package in one step:

./scripts/package-kual.sh

This fixed workflow always:

• clears dist/
• rebuilds both Kindle binaries
• recreates dist/filebrowser-kual-package.zip

Output Artifacts

• dist/filebrowser-kindle-hf
• dist/filebrowser-kindle-sf
• dist/filebrowser-kual-package.zip

Kindle Install

Unzip dist/filebrowser-kual-package.zip and copy filebrowser-kual/ to:

• /mnt/us/extensions/filebrowser/

Then start from KUAL:

• Start File Browser
• Stop File Browser
• File Browser Status

Default URL:

• http://<kindle-ip>:8088

Upstream Sync Strategy

Recommended remotes:

• upstream -> https://github.com/filebrowser/filebrowser
• origin -> your fork

Sync flow:

git fetch upstream
git checkout master
git merge --ff-only upstream/master
git checkout main
git rebase master
git push --force-with-lease origin main

Notes

• Kindle quick setup default user home base path is set to /mnt/us.
• KUAL scripts are path-agnostic and resolve extension root from script location.

Upstream Project

Original project:

• https://github.com/filebrowser/filebrowser
• https://filebrowser.org

License

Same as upstream: Apache License 2.0.