Usage Collections

Collections

Part of the Usage reference. · ← Previous: Store & discovery · Next: Installation & maintenance →

Steam library collections are the named categories you group games into in the Steam client (e.g. "RPGs", "Finished", plus the built-in Favorites and Hidden). Aurelia keeps a local working copy in ~/.config/Aurelia/collections.json that you edit offline: create/rename/delete collections and add/remove games with no login. Those edits reach your Steam account only when you explicitly pull, push, or sync.

Collections come in two kinds:

• Static: an explicit list of games. These are the ones you create and edit here.
• Dynamic: membership is a saved filter (tags, platforms, …) that Steam evaluates. Aurelia round-trips these verbatim and never edits them, so a sync won't clobber them. add, remove, and delete refuse to touch a dynamic collection.

The built-in favorite and hidden collections can have games added/removed but cannot be deleted.

Caution

push and sync write to your real Steam cloud account and change the collections you see in the Steam client on every device. They ask for confirmation first. Pass --yes to skip the prompt. In --json mode there is no prompt, so --yes is required. pull and all local edits are safe. If a push is rejected because your local copy is stale, run aurelia collections pull first, then push again.

Every subcommand honors the global --json flag.

collections list

List every collection with its kind and static game count.

aurelia collections list
aurelia collections list --json

collections show

Show a collection's member app ids. Accepts a name (case-insensitive) or an id. Dynamic collections can't be listed offline (Steam computes their members).

aurelia collections show "RPGs"
aurelia collections show uc-1a2b3c4d --json

collections create / rename / delete

aurelia collections create "RPGs"              # new static collection
aurelia collections rename "RPGs" "Role-Playing"
aurelia collections delete "Role-Playing"      # marked deleted locally; removed from Steam on push

delete marks the collection for deletion locally. It is tombstoned in Steam on the next push/sync. Built-in favorite/hidden can't be deleted.

collections add / remove

Add or remove one or more games (by app id) to/from a collection. remove records the game as excluded even if it was previously added.

aurelia collections add "RPGs" 570 730 1245620
aurelia collections remove "RPGs" 730

collections pull

Download your collections from Steam and merge them into the local store: memberships are unioned per collection, brand-new remote collections are added, and remote deletions are applied. Requires a logged-in session (aurelia login). Safe: it never writes to Steam.

aurelia collections pull
aurelia collections pull --json

collections push / sync

push uploads every local collection to your Steam account. sync does a pull (to merge in any remote changes) followed by a push. Both mutate your real Steam library and require confirmation or --yes.

aurelia collections push            # prompts: "About to upload N collection(s)… Continue? [y/N]"
aurelia collections push --yes      # skip the prompt
aurelia collections sync --yes      # reconcile both sides
aurelia collections push --yes --json

The list command also integrates collections: it shows a COLLECTIONS column (the comma-joined names of the static collections each game belongs to), and aurelia list --collection "<name>" filters the library to a single collection's members. See list.