Pretty Garage

Pretty Garage is a GUI-base garage tool for Stunts developed by Cas aimed at providing a comfortable experience and ease of use. The project was started on 19 January 2024 and quickly reached version 1. By early March in the same year, it was already capable of accessing online repositories, a feature still unavailable to its CLI-oriented counterpart Simple Garage, whilst the latter allows for a more powerful set of commands and filtering options.

Pretty Garage can render car images on-the-fly, which makes it easier to identify cars and has been made with the idea of eventual compatibility with the Car Archive project, led by dreadnaut.

Garage handling

Like Simple Garage, Pretty Garage supports the definition of one or more garage directories, besides Stunts' main path, which is also used in a similar way. Cars can be exchanged between these garages rather freely. Stunts' path only differs in that it cannot hold more than 32 cars and one car can be defined as default (normally, the Countach) and cannot be moved out of the directory. However, these rules can be overridden, as most actions in the program have the option of becoming forceful if the shift key is being held down.

Junkyard

The user can define one garage to be the junkyard. If a junkyard is defined, attempting to delete one or more cars will immediately send them to that directory without confirmation, unless they are being deleted from the junkyard itself. This is similar to the behaviour of trash cans in desktop OSs. In Pretty Garage, the first garaged with a name that begins with "junk" (case insensitive) is set to be the junkyard, if it exists. Without a junkyard, the user will always be prompted for confirmation when deletion is attempted and if approved, it will be permanent.

Groups

Groups in Pretty Garage work in the same way as in Simple Garage. They are lists of car IDs. Offline (normal) groups can be modified freely and while browsing a group, you're able to see where the cars in the list are located, as long as they are found locally in Stunts or any of the defined garages.

Online repositories

The program supports two forms of online lists: repository indices and online groups. A repository index is a file located somewhere online that contains a list of car names, IDs and where to find them. They don't have to necessarily be hosted at the same location as the index, so the actual "repository" isn't the index itself. In fact, the same index could link to several sources.

An online group is also a file found online, but it only contains a list of car IDs. Pretty Garage will treat it as a read-only group. These are useful, for example, if a tournament wants to publish the list of allowed cars for the season or somebody would like to issue the list cars they're maintaining, but without issuing sources. Pretty Garage will only be able to retrieve these cars if they are found locally.

To download lists and cars, Pretty Garage relies on curl, as it does not include third-party libraries for HTTPS communication. If curl is not installed on your system, the program will still work, but you won't be able to download any files.

Differences from Simple Garage

Besides the fundamental fact that Pretty Garage is a GUI program and Simple Garage is CLI-based, there are a number of internal details that have a different design in these two tools and may not be apparent at first sight.