Rogue Class Linux Download Login

Update of "userguide"


Artifact ID: 51a366cb58a09e6df16820fc2067c2b4790e755c
Page Name:userguide
Date: 2017-05-27 04:08:08
Original User: bencollver
Parent: 22eac6f7a1578cd0531be1e1ca60372ad3006fcb

Main / User Guide


Rogue Class is a toy Linux distribution for playing games and reading books. Rogue Class Linux has a streamlined installer and it supports joystick controls in most of the programs. RCL favors turn-based games, such as puzzles and rogue-like games.

In 2007 i was given a GP2X for my birthday. It ran Linux and NetHack on two AA batteries. I could simply download a .zip file, extract it to the SD card, and then run the application. It was simple to develop for. Simply write a Linux application using SDL, and then cross-compile it for the ARM processor. This simplicity reminded me a little of MS-DOS: a program could have direct access to the hardware with minimal interference from the system. The community-created GP2X game ports were great. They tended to have custom code to deal with the small QVGA screen and the lack of mouse and keyboard input. This GP2X scene is the inspiration. Rogue Class Linux can run the same kind of software, but on an old PC.

Rogue Class is based heavily on Slackware Linux. The scripting language is TCL. See also this chart of graphical sub-systems.

Minimum requirements

Note that multiple displays are not supported. The Linux framebuffer works best with a single display.

Note that multiple audio devices are not supported. The ALSA subsystem supports multiple audio devices, but the configuration is technical.

Install guide

First boot


Click for Games

Game development

Click for Game development

How to use a joystick

Rogue Class Linux has good joystick support. For hotplug USB joysticks, RCL will automatically configure the joystick when you plug it in. Otherwise, you will need to follow the manual configuration instructions.

Note: The joystick configuration may be hotplug, but the games and menus are not. You will need to close and re-open the current game or menu to use the newly plugged-in joystick.

Many of the roguelike games share common joystick controls. You can also use the virtual keyboard, as described below.

How to use the virtual keyboard and mouse

Most of the games in Rogue Class Linux have been modified to include a virtual keyboard and mouse. This makes it possible to play a complex rogue-like game with a joystick. If your controller lacks triggers, you may use the shoulder buttons instead.

To open the virtual keyboard, press the left trigger. Press the left trigger again to dismiss it. While the virtual keyboard is open, press the right trigger to shift to uppercase letters and symbols. Use directions to select a virtual key. Press the B button to press the selected virtual key. See also common joystick controls.

The virtual keyboard and the virtual mouse are mutually exclusive. This means you must dismiss the virtual keyboard before you can use the virtual mouse, and vice versa.

To enable the virtual mouse, hold down the right + left triggers together. Then let go of both triggers. To disable the virtual mouse, hold down both triggers together again. Use directions to move the mouse pointer slowly. Hold down the right trigger while moving the mouse to move it quickly. Press the B button to left-click. Press the A button to right-click.

In some games you can drag and drop with the virtual mouse. Hold down the right trigger + Start button together to enable drag mode. In drag mode, press the B button and let go. This will start dragging. Use the directions to drag the mouse pointer. Then press the B button again to stop dragging. To go back to normal mouse button mode, hold down the right trigger + Start button together again.


How to backup


How to restore

How to use multiple consoles

Rogue Class Linux programs are full-screen graphical programs. You can run multiple programs by using multiple consoles. To switch to another console, press Ctrl-Alt-F1 through Ctrl-Alt-F6. After you have switched to another console, you may need to press Enter to activate the new console.

Note that this feature does not work well on all graphics controllers. On some controllers you will experience side effects, such as console 2 corrupting the graphics of console 1.

Only one program can use a joystick and mouse at a time. For this reason, the joystick and mouse are assigned to the first console by default. Programs on the other consoles will use keyboard input. You can use the system menu to reassign the joystick or mouse to a different console.

DirectFB and SDL2 applications are an exception to the mouse locking, and these programs can use the mouse on any console at any time.

How to take a screenshot

Note: In DirectFB and SDL2 applications, you may simply press the Print Screen button on the keyboard to take a screenshot. Then use the file manager to browse to the home directory and open a dfm_####.ppm screenshot file. This will open the screenshot menu for that file. Currently the DirectFB applications in Rogue Class Linux are Dungeon Crawl Stone Soup, Hydra Slayer, Pysol, Rogue, Tome4, and Veins of the Earth. For all other applications, use the following instructions.

First, read the section on using multiple consoles. If you wish to take a screenshot, then you must use another console to do so. This example will use console 2 to take a screenshot of console 1.

Note: You cannot take a screenshot of a greater numbered console. You cannot take a screenshot of console 2 if you run the screenshot app on console 1.


How to configure networking

How to configure a sound card

Rogue Class Linux will automatically configure PCI and USB audio devices. One catch is that it only supports a single audio device at a time. If your PC already has built-in audio and you plug in a USB audio device, then Rogue Class Linux will use the built-in audio instead of USB audio. If you have an older PC then you may need to probe the ISA audio device before you can use sound.


How to subscribe to a podcast


You can view additional documentation from the file manager. Click Go, Documentation, and browse to the desired documentation.

You can view additional documentation in the Apps / Manuals menu. For example, you could search for SDL to list all of the SDL manuals.

The Linux fbcon system is fragile on some hardware. If a program crashes then you should probably reboot the PC. Even if it seems to be working OK, program crashes can put fbcon in a weird state. This is especially true when using multiple consoles.

Rogue Class Linux is intended to be entirely menu driven. However, you can access the command prompt if you wish. If you get a password prompt then the word rogue is probably the default password. You can use the sudo command to get unrestricted superuser access.