Files
DroidDeck/tools/linuxfs/overlay/usr/local/bin/bannerlator-steam-library
T
The412Banner fa25451766 Game storage: a second Steam library on an SD card or a chosen folder
The runtime already knew how to register /mnt/bannerlator-sd with the client; the app never
bound anything there, so the client only ever saw internal storage. The Steam cog's Game storage
section offers every removable volume (through the app's own folder on it, the one place a card
lets a targetSdk-28 app write) and any folder from the File Manager, proven writable first. The
session binds the choice and names it (BL_LIBRARY_LABEL); bannerlator-steam-library registers it,
or forgets it when nothing is bound. The client does the rest: asks where to install, shows both
on Storage, moves games between them. device.txt records the choice.
2026-09-22 08:18:20 -04:00

166 lines
7.0 KiB
Python
Executable File

#!/usr/bin/python3
# Registers the card the app installs to (bound at /mnt/bannerlator-sd) as a library folder of the
# native Steam client, so they show as installed there instead of being downloaded a second time.
#
# bannerlator-steam-library <steam root>
#
# Ported from WinNative's gamescope runtime (GPL-3.0).
import os
import re
import sys
# The client's own library is internal storage (its steamapps/common is bound to the app's root);
# the card is the one extra library folder.
# The app binds the storage the user chose (Steam cog -> Game storage) at this path and names it
# in BL_LIBRARY_LABEL; nothing bound = internal only, and the entry is removed so the client does
# not keep offering a place that is not there.
LIBRARIES = (("/mnt/bannerlator-sd", os.environ.get("BL_LIBRARY_LABEL", "SD Card")),)
# The client calls its own library "Local Drive (/)", which says nothing about where that is.
# It is the phone's internal storage, so say so.
MAIN_LABEL = "Internal Storage"
def register(steam_root, library, label):
"""Adds one library folder to the client's list; the client then offers it as an install
location as well as reading the games already in it. Registered even when empty: a new user
should be able to install straight into it."""
steamapps = os.path.join(library, "steamapps")
if not os.path.isdir(steamapps):
return 0
apps = sorted(
int(m.group(1))
for m in (re.fullmatch(r"appmanifest_(\d+)\.acf", n) for n in os.listdir(steamapps))
if m
)
marker = os.path.join(library, "libraryfolder.vdf")
if not os.path.isfile(marker):
with open(marker, "w", encoding="utf-8") as f:
f.write('"libraryfolder"\n{\n\t"contentid"\t\t"%d"\n\t"label"\t\t"%s"\n}\n'
% (int.from_bytes(os.urandom(8), "little"), label))
steamapps_dir = os.path.join(steam_root, "steamapps")
path = os.path.join(steamapps_dir, "libraryfolders.vdf")
text = ""
if os.path.isfile(path):
with open(path, encoding="utf-8", errors="replace") as f:
text = f.read()
if re.search(r'"path"\s+"%s"' % re.escape(library), text):
return len(apps)
indexes = [int(i) for i in re.findall(r'^\t"(\d+)"\s*$', text, re.M)]
if not text.strip():
text = ('"libraryfolders"\n{\n\t"0"\n\t{\n\t\t"path"\t\t"%s"\n\t\t"label"\t\t""\n\t}\n}\n'
% steam_root)
indexes = [0]
entry = ['\t"%d"' % (max(indexes) + 1), "\t{", '\t\t"path"\t\t"%s"' % library,
'\t\t"label"\t\t"%s"' % label, '\t\t"apps"', "\t\t{"]
entry += ['\t\t\t"%d"\t\t"0"' % app for app in apps]
entry += ["\t\t}", "\t}"]
closing = text.rstrip().rfind("}")
if closing < 0:
return len(apps)
text = text[:closing] + "\n".join(entry) + "\n" + text[closing:]
os.makedirs(steamapps_dir, exist_ok=True)
with open(path, "w", encoding="utf-8") as f:
f.write(text)
print("bannerlator-steam-library: registered %s with %d game(s)" % (library, len(apps)))
return len(apps)
RETIRED = ("/mnt/bannerlator",)
def forget(steam_root, library):
"""Removes a library folder earlier builds registered and this one no longer binds, so the
client does not keep offering a location that is not there."""
path = os.path.join(steam_root, "steamapps", "libraryfolders.vdf")
if not os.path.isfile(path):
return
with open(path, encoding="utf-8", errors="replace") as f:
lines = f.read().split("\n")
out, block, depth = [], None, 0
for line in lines:
if depth == 1 and re.fullmatch(r'\t"\d+"', line):
block = [line]
continue
if block is not None:
block.append(line)
depth += line.count("{") - line.count("}")
if depth == 1:
if not re.search(r'"path"\s+"%s"' % re.escape(library), "\n".join(block)):
out.extend(block)
block = None
continue
depth += line.count("{") - line.count("}")
out.append(line)
text = "\n".join(out)
if text != "\n".join(lines):
with open(path, "w", encoding="utf-8") as f:
f.write(text)
print("bannerlator-steam-library: forgot %s" % library)
def relabel(steam_root, target, label):
"""Names a library for what it is. The client writes its own entry with an empty label and
falls back to showing the mount point - "Local Drive (/)" - so the install dialog gives no
clue which of the two places is the phone and which is the card. A library registered on an
earlier run keeps whatever label it was given then, so both are named here every time."""
path = os.path.join(steam_root, "steamapps", "libraryfolders.vdf")
if not os.path.isfile(path):
return
with open(path, encoding="utf-8", errors="replace") as f:
lines = f.read().split("\n")
out, depth, block, changed = [], 0, None, False
for line in lines:
if depth == 1 and re.fullmatch(r'\t"\d+"', line):
block = [line]
continue
if block is not None:
block.append(line)
depth += line.count("{") - line.count("}")
if depth == 1:
text = "\n".join(block)
if re.search(r'"path"\s+"%s"' % re.escape(target), text):
new = re.sub(r'("label"\s+")[^"]*(")', r"\g<1>%s\g<2>" % label, text, count=1)
if new != text:
changed = True
text = new
out.extend(text.split("\n"))
block = None
continue
depth += line.count("{") - line.count("}")
out.append(line)
if changed:
with open(path, "w", encoding="utf-8") as f:
f.write("\n".join(out))
print("bannerlator-steam-library: labelled %s %r" % (target, label))
# A library also carries its own libraryfolder.vdf, and the client takes the label from there
# back into the list above - so editing the list alone is undone on the next start. The
# client's own library has no such file, which is why that one kept the new name and the card
# went back to the name it was first registered with.
marker = os.path.join(target, "libraryfolder.vdf")
if not os.path.isfile(marker):
return
with open(marker, encoding="utf-8", errors="replace") as f:
text = f.read()
new = re.sub(r'("label"\s+")[^"]*(")', r"\g<1>%s\g<2>" % label, text, count=1)
if new != text:
with open(marker, "w", encoding="utf-8") as f:
f.write(new)
print("bannerlator-steam-library: labelled %s in its own marker too" % target)
def main():
steam_root = sys.argv[1]
for library in RETIRED:
forget(steam_root, library)
relabel(steam_root, steam_root, MAIN_LABEL)
for library, label in LIBRARIES:
if os.path.isdir(os.path.join(library, "steamapps")):
register(steam_root, library, label)
relabel(steam_root, library, label)
else:
forget(steam_root, library)
if __name__ == "__main__":
main()