A new version of Legendary has been released. Legendary is an open-source game launcher that can download and install games from the Epic Games platform on Linux and Windows.

Legendary 0.20.12 - Highway 17

New feature release that adds automatic aliases as well as CLI alias management.

CLI Changes

• [New] alias command
  • Four actions: add, rename, remove, list
    • add adds new alias, example: legendary alias add Eider hm3 will create the alias "hm3" for "HITMAN 3"
    • rename will rename an alias, example legendary alias rename hm3 hit3 will rename "hm3" to "hit3"
    • remove will delete an alias, example legendary alias remove hit3 will remove alias "hit3"
    • list  will show all user-defined and automatic aliases for the specified title, example: legendary alias list Eider. This also resolves alias itself so for example legendary alias list hitman3 will also work
    • list will show all user-defined aliases

Auto-Aliasing

This version of legendary features a new method that automatically generates aliases for your games. The goal of this feature is to improve the usability of common commands by making them more human readable. For instance if you wish to install "Kena: Bridge of Spirits" you can now simply type legendary install kena and it will do it!

These aliases follow common patterns that people use to abbreviate game titles, and also include the game's title and installation directory name itself. These aliases are case-insensitive (unlike user-defined ones) and are treated as lower priority than user-defined aliases.

Examples of alias generation results

• "Fortnite" (single word name)
  • fortnite
• "Among Us" (multiple words, no numerals)
  • among, amongus, among us, au
• "Grand Theft Auto V" (multiple words, roman numerals)
  • grand theft auto v, grandtheftauto5, grandtheftautov, gta5,gtav
• "STAR WARS Battlefront II: Celebration Edition" (multiple words, roman numerals, colon)
  • star wars battlefront ii, star wars battlefront ii celebration edition, starwarsbattlefront2, starwarsbattlefront2celebrationedition, starwarsbattlefrontii, starwarsbattlefrontiicelebrationedition, swb2, swb2ce, swbf2, swbf2ce, swbfi, swbfice, swbfii, swbfiice, swbi, swbice, swbii, swbiice (Yeah, it's a long one)
  • In this case legendary will try to be smart about the word "Battlefront" to separate it into "bf" rather than just "b"
• "Warframe" (single word, but with "f" in the middle)
  • warframe, wf

Additionally the first word that is not "the", "for", or "of" will also be used as an alias as long as no conflicts exist. For instance "Ghostbusters The Video Game Remastered" will be shortened to ghostbusters, provided you do not own any other game that also starts with "Ghostbusters".

Since aliases may change or be removed when new games are purchased and collisions occur, or the algorithm is changed, it is recommended to also manually set those you expect to use commonly.

Auto-aliasing can be disabled via the config via the disable_auto_aliasing option.

Bug fixes and improvements

• Fixed ETA when elapsed time is greater than one hour  #345
• Title and app name are now logged when starting the installation process ot make it obvious which title is being installed when using aliases

Release 0.20.12 - Highway 17 · derrod/legendary