A game library script written in bash
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
ArcticTheRogue 28eb503d9a Merge pull request 'Fix a tiny typo' (#2) from taminaru/asgl:master into master 1 year ago
Screenshots Added screenshots 2 years ago
LICENSE Add LICENSE 2 years ago
README.md Fix a tiny typo 1 year ago
asgl Fixed the list command so that .sh does not appear 1 year ago


What is asgl?

agsl, also known as Arctic's Simple Game Library.

ASGL is a script written in Bash made for managing games.

Instead of opening a GUI to manage your games, ASGL offers a more terminal-friendly approach. With ASGL, you may list; modify or run your games.


Installation of asgl is very simple, all you need to do is move or copy it to your $PATH, for example: /usr/local/bin.

How to use asgl

Executing ASGL opens an interactive prompt, in which you can type commands to run; list or modify your list of games.

Adding games

To add a game type a and then follow the prompts.

First you will be asked to enter the name of the game, then the executable for the game. Finally, you will be asked if you are sure if you want to add the game.

Here is an example:

$ asgl
Type a command (h for help): # a
What is the name of the game?: # xonotic
Where is the executable for xonotic?: # xonotic-glx
Would you like to save this game?: [y/n] # Y
Adding xonotic!
Game Added!

Listing games

To list the games you have added to asgl, type l in the ASGL prompt, as seen below:

$ asgl
Type a command (h for help): # l


Playing games

To play a game, type p inside the ASGL prompt. This can be observed below.

$ asgl
Type a command (h for help): # p

What game would you like to play?: xonotic

Removing games

If for whatever reason you wish to remove a game you can do so by typing r, then following the prompts.

Firstly, you will be asked for the name of the game, and then to confirm that you want to delete it. If you confirm then the game will be deleted from asgl.

$ asgl
Type a command (h for help): # r

What game would you like to remove?: # xonotic
Would you like to remove xonotic? [Y/n] # y

Getting help

If you ever need help with asgl you can type h and you will be given all the commands and their functions.

$ asgl
Type a command (h for help): # h

a/A -------- Add a game.
r/R -------- Remove a game.
p/P -------- Play a game.
l/L -------- List games.
h/H -------- List of commands.
q/Q -------- Exit.

Future Plans

In the future, I plan to extend this command with an extended set of functions, such as:

  • Add categories
  • Improve the list command
  • Port to another language
  • Add the ability to import .desktop files (I decided being able to import Steam libraries was a better idea)
  • Making it so games are listed with a number and you play them with this number
  • Add the ability to import Steam libraries