<- Back to homepage

Before Continuing

• Some steps diverge into two. You only have to follow one base on your scenario.
  • Steps labeled "a" denote steps to follow if your OS is installed on a Virtual Machine (VM).
  • Steps labeled "b" denote steps to follow if your OS is installed on a physical machine (PC).
• If you installed Red Star OS on a PC, you need a second PC and a USB flash drive to do the work; If you installed Red Star OS on a VM, do the work on your host system.

Step 1:

Step 1a (VM):

Download the script iso from here and save it somewhere convenient.

Step 1b (PC):

Plug in your USB drive, download the script file from here and save it to your USB drive.

Step 2:

Step 2a (VM):

Boot up your Red Star OS, login, then detach control from your VM (VirtualBox is Left Ctrl, VMware is Ctrl + Alt). Mount kimfetch.iso to your VM. Screenshots below shows how to do it for VirtualBox 7.0.

Step 2b (PC):

Boot up your Red Star and login. Then, plug in your USB drive.

Step 3:

Make sure an icon shows up on your desktop. If system prompt whether to open it, ignore & close it.

Open up the terminal. The location is shown in screenshot:

You may drag the icon to the bottom menu bar to create a shortcut.

Step 4:

Navigate to your iso (or USB drive if you're installing from that):

cd /media/kimfetch

If location doesn't exist, it's likely at /mnt:

cd /mnt/kimfetch

Copy the kimfetch file to your home directory:

cp ./kimfetch ~/

You may now unmount the iso file or disconnect the USB drive.

Step 5:

Navigate back to home directory:

cd ~

Test the script:

bash ./kimfetch

If the script executes as expected, you may go to Step 6. Otherwise, grant the script permission to execute:

chmod +x ./kimfetch

Now try executing kimfetch again.

Step 6:

We are going to edit an important script .bashrc, so make a back up for it just in case.

cp ./.bashrc ./.bashrc-bak

Append the line bash ./kimfetch to the end of .bashrc file:

sed -e '${s/$/\nbash\ .\/kimfetch/}' ./.bashrc >> ./.bashrc

Clean up:

Test it out by either exiting and reopening the terminal, or enter the following command:

clear; ./kimfetch

Due to the default size of the terminal, your fetch might look like this:

To change the default size of the terminal, hover your cursor to either the left or right edge of the terminal window and drag it.

The option to save current size of terminal as default is shown below:

Test It Out!

You should now have a lovely neofetch like output each time you open the terminal.

If you encounter any issue, post it here and I will gladly help out.

<- Back to homepage