5. Set up the Pironman


  • This Pironman is used in the same way as PC and requires the power button to power on/off.

  • The Pironman is currently only available for Raspberry Pi OS.

Change the config.txt

Before you can start using Pironman, you need to configure the power button and the IR receiver.

Open the /boot/config.txt file with the following command.

sudo nano /boot/config.txt

Add the following text to the end of the file, noting that there should be no spaces on either side of the =.


Press Ctrl+X -> Y -> Enter to save and exit editing.

Then you will need to reboot Raspberry Pi to take effect.

sudo reboot

Install pironman module

Use the following commands to download and install the pironman module.

cd ~
git clone https://github.com/sunfounder/pironman.git
cd ~/pironman
sudo python3 install.py

After installation, the program will start automatically. Here are the basic configurations for Pironman.

  • The OLED screen will display the CPU, RAM and ROM Usage, CPU Temperature and IP Address of the Raspberry Pi.

  • After 60 seconds, the OLED display goes into sleep mode, and you can wake it up by a short press on the power button.

  • The fan is turned on at 50 degrees Celsius.

  • Turn on the WS2812 RGB strip so that it displays in color #0a1aff(blue) and in breath mode (change rate is 50%).

  • At this point, you can press and hold for 2 seconds to safely shut down or 10 seconds to forcibly shut down.


If you are using Raspberry Pi OS Lite, you will need to install git and python3 first, which you can do with the following commands.

sudo apt update
sudo apt install git python3-pip python3-setuptools python3-smbus

Modify the Configuration

In the pironman module, we have some basic configurations for Pironman, and you can check them with the following command.

pironman -c

The current configurations are shown below.

  • The fan is turned on at 50 degrees Celsius.

  • The duration of the OLED display is 60s, after 60s it will start to sleep.

  • Turn on the WS2812 RGB strip so that it displays in color #0a1aff and in breath mode (change rate is 50%).


You can also modify these configurations to suit your needs.

Use pironman or pironman -h or pironman --help to view the instructions, as follows.

pironman <OPTION> <input>

start            start pironman service
stop             stop pironman service
restart          restart pironman service
-h,--help        help, show this help
-c,--check       show all configurations
-a,--auto        [ on ],enable auto-start at boot
                [ off ], disable auto-start at boot
-u,--unit        [ C/F ], set the unit of temperature,
                    C or F (Celsius/Fahrenheit)
-f,--fan         [ temp ], Temperature at which the fan switches on,
                in celsius (default 50),in range (30 ~ 80)
-al,--always_on  [on/off], whether the screen is always on,
                default False
-s,--staty_time  [time], screen display duration in second,
                in second, default 30
-rw,--rgb_sw     [on/off], rgb strip switch
-rs,--rgb_style  rgb strip display style, default: breath,
                in [breath / leap / flow / raise_up]
-rc,--rgb_color  [(HEX)color], set the color of rgb strip,
                default: 0a1aff
-rb,--rgb_speed  [speed], rgb blink speed (0 ~ 100, default 50)

For example, to turn off the automatic execution of programs at boot.

pironman -a off

Or reset the color of WS2812 RGB strip.

pironman -rc ff8a40

Those configurations are stored in /.config/pironman/config.txt, and you can also make changes directly in this file.

sudo nano ~/.config/pironman/config.txt

Press Ctrl+X -> Y -> Enter to save and exit editing.


For details on the introduction and configuration of the components in Pironman, please refer to: 6. About Hardware.