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, examplelegendary alias rename hm3 hit3
will rename "hm3" to "hit3"remove
will delete an alias, examplelegendary alias remove hit3
will remove alias "hit3"list <app name/alias>
will show all user-defined and automatic aliases for the specified title, example:legendary alias list Eider
. This also resolves alias itself so for examplelegendary alias list hitman3
will also worklist
will show all user-defined aliases
- Four actions:
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