R.L.S.D.

Welcome to

• Retro
• Looking
• Statistics
• Display

The purpose of this project is for devices to send statistics to a host machine that will display the information on a retro looking TUI. I started this project because I thought it'd be fun.

Setup

The script was built using Amber, please install the following package: bc

The script requires root access as it will place the binary in /usr/lib/rlsd and create a systemd service

Run the following commands:

    # Downloads the script
    curl -o rlsd-install.sh https://raw.githubusercontent.com/MADMAN-Modding/rlsd/refs/heads/master/install-scripts/linux/setup.sh
    
    # Makes it executable
    chmod +x rlsd-install.sh

    # Run the script as root
    sudo ./rlsd-install.sh

    # Remove the script
    rm rlsd-install.sh

Updating

The script was built using Amber, please install the following package: bc

The script requires root access as it will place the binary in /usr/lib/rlsde

Run the following commands:

    # Downloads the script
    curl -o rlsd-update.sh https://raw.githubusercontent.com/MADMAN-Modding/rlsd/refs/heads/master/install-scripts/linux/update.sh
    
    # Makes it executable
    chmod +x rlsd-update.sh

    # Run the script as root
    sudo ./rlsd-update.sh

    # Remove the script
    rm rlsd-update.sh

Building

Dependencies

Rust is needed to compile this project, grab it here

Arch

// Install the dependencies needed
sudo pacman -S --needed \
    base-devel \
    pkgconf \
    openssl \
    sqlite \
    libudev \
    cmake \
    zlib

Fedora

// Install the dependencies needed
sudo dnf install -y \
    gcc \
    pkgconf-pkg-config \
    openssl-devel \
    sqlite-devel \
    libudev-devel \
    cmake \
    make \
    zlib-devel \ 
    git

Debian/Ubuntu

// Install the dependencies needed
sudo apt update && sudo apt install -y \
    build-essential \
    pkg-config \
    libssl-dev \
    libsqlite3-dev \
    libudev-dev \
    cmake \
    zlib1g-dev

Clone the project

git clone https://github.com/MADMAN-Modding/rlsd.git

Building

Linux

To build the default Linux configuration for the Rust project

cd rlsd

cargo build --release

Linux Musl

If you run into glibc version issues do the following

cd rsld

rustup target add x86_64-unknown-linux-musl

cargo build --release --target x86_64-unknown-linux-musl

Running

If you run into issues running the project, try using Linux Musl

Linux

// Make the binary executable
chmod +x target/releases/rlsd

// Run the binary    
./target/release/rlsd --help

Linux Musl

// Change directory to the musl release
cd target/x86_64-unknown-linux-musl/release    

// Make the binary executable
chmod +x rlsd

// Run the binary
./rlsd --help