Skip to content

freifunk-berlin/falter-packages

Repository files navigation

Freifunk Berlin: Falter Firmware

Overall Project Structure and Falter Repositories

The Falter project builds a modern OpenWrt-based firmware for Freifunk Berlin. We split our code on different repositories. For the beginning there are three main repositories you should know:

  • packages: This repo holds the source code for an OpenWrt package feed. All falter specific packets reside there, regardless if they are luci-apps or just command-line-apps. Everything should be bundled as a package. If you want to file an issue or fix a bug you probably want to go here.
  • builter: The builter assembles Freifunk images from the OpenWrt-imagebuilder and the pre-compiled package feed from repo-builder. If you want to include a new app into falter, you'd need to add it to the packagelists defined here.

Specific Comments on this Repo

You will find a directory doc/ in this repository, which contains several documents on workflows, installation, building etc. It is planned, to have an automated documentation system for the falter-packages there too.

Write your Apps translatable, please

To get apps translated easily into another language, you should write your message prompts in a special way. For more information on that and a tutorial for actually translation, please go to doc/translation.md.

Compiling

In the build/-directory in this repository, you can find a build-script. It will download all necessary OpenWrt-SDKs, to compile the packages in this feed for a given architecture. The packages will appear in a directory of your choice. Please refer to compiling.md for a more detailed tutorial on how to use that script. For a very quick start, take this:

# script-name, openwrt-version, CPU-architecture, output-directory
build/build.sh openwrt-22.03 mips_24kc out/

Installation

You might include packages from this repository into your self-compiled OpenWrt-images. For detailed installation look at installation.md.

Or just add following line to feeds.conf

src-git falter https://github.com/freifunk-berlin/falter-packages.git