Python library for parsing the most common Steam file formats.
steamfiles requires Python 3.3+
Install the latest stable version:
pip install steamfiles
Import a module for your desired format:
# Use one of these, or all at once! from steamfiles import acf from steamfiles import appinfo from steamfiles import manifest
Easily load data, modify it and dump back:
with open('appinfo.vdf', 'rb') as f: data = appinfo.load(f) # Calculate the total size of all apps. total_size = sum(app['size'] for app in data.values()) print(total_size) # Downgrade a change number for all apps. for app in data.values(): app['change_number'] -= 1 with open('new_appinfo.vdf', 'wb') as f: appinfo.dump(data, f)
Caution: all formats are parsed into
dict by default, so the order of data is very likely not the same.
As I’m not sure how Steam and related tools deal with rearranged data, pass an
OrderedDict class to the
wrapper parameter if you plan to write data back and use it later:
from collection import OrderedDict data = acf.load(f, wrapper=OrderedDict) # works with other formats as well
More in progress…
- [✓] ACF support
- [✓] appinfo.vdf support (Binary VDF)
- [✓] Manifest support
- [?] packageinfo.vdf (Another binary VDF)
- [?] UserGameStats (achievements)
- [?] Text VDF files (are they actually ACF?)
steamfiles is distributed under the terms of the MIT license.
See the bundled LICENSE file for more details.