n900kbfx

A very simple utility for controlling the keyboard backlight on the Nokia N900 phone, specially designed for PostmarketOS.

With love ❤️ from an enthusiast to enthusiasts ⚡

n900kbfx.mp4

Install

Currently, the program is not available in official repositories, but you don’t need to build it manually just to install it.

Check out the GitHub releases for prebuilt binaries and install them :)

sudo apk add n900kbfx.apk --allow-untrusted

How to use

Turn on/off backlight

n900kbfx s on

n900kbfx s off

Manually controlling each LED

The Nokia N900 phone has 6 LEDs under the keyboard. Use this command to instantly and safely change the brightness of each LED manually.

n900kbfx s 1 255

n900kbfx s 6 0

Animations

Just some different animations you can use, for example when displaying your phone on a stand.

Not very practical, but oh so beautiful! ✨

⚠️ Attention!

During the animation, the program will run in the background and change the brightness of every LED every millisecond. Due to the weak CPU of the Nokia N900, the load may reach up to 10%!

Just keep this in mind UwU 💡

n900kbfx a sine

n900kbfx a wave

TODO: We need to implement more animations, send PR :3

Configuring animations

You can customize each animation, but you’ll need to modify the animations.h file in the source code and rebuild project.

struct SineConfig {
    int delay_us = 30000;
    float speed = 0.15f;
};

struct WaveConfig {
    int on_duration_ms = 500;
    int off_duration_ms = 500;
};

TODO: A user-friendly configuration option will be added in the future, so no recompilation will be needed.

Manually build

Before building, make sure you have the latest version of pmbootstrap installed correctly. Pls, just use any Linux distro! (btw)

1. Navigate to the pmaports directory and create a new directory.

cd $HOME/.local/var/pmbootstrap/cache_git/pmaports
mkdir -p community

2. Clone the project repo into the directory you created in the previous step

cd community
git clone https://github.com/progzone122/n900kbfx

3. Let's build it!

./build.sh --release

4. Enable ssh on your device
5. Configure config.sh by specifying the correct data for connecting via ssh.
6. Install the program to device using sideloading :)

./sideload.sh