{"id":24651645,"url":"https://github.com/constup/vdf-converter-powershell","last_synced_at":"2025-10-07T11:31:25.982Z","repository":{"id":272470923,"uuid":"916499516","full_name":"constup/vdf-converter-powershell","owner":"constup","description":"VDF (Valve Data File) converter for PowerShell","archived":false,"fork":false,"pushed_at":"2025-01-14T16:52:43.000Z","size":12,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-14T18:18:02.362Z","etag":null,"topics":["powershell","steam","valve-keyvalues-files","vdf","vdf-converter","vdf-parser"],"latest_commit_sha":null,"homepage":"","language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/constup.png","metadata":{"files":{"readme":"README.adoc","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-14T08:07:23.000Z","updated_at":"2025-01-14T17:40:00.000Z","dependencies_parsed_at":"2025-01-14T18:18:08.033Z","dependency_job_id":"14945371-f33f-40ff-9249-2813798cfcce","html_url":"https://github.com/constup/vdf-converter-powershell","commit_stats":null,"previous_names":["constup/vdf-converter-powershell","constup/vdf-parser-powershell"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/constup%2Fvdf-converter-powershell","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/constup%2Fvdf-converter-powershell/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/constup%2Fvdf-converter-powershell/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/constup%2Fvdf-converter-powershell/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/constup","download_url":"https://codeload.github.com/constup/vdf-converter-powershell/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235621565,"owners_count":19019522,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["powershell","steam","valve-keyvalues-files","vdf","vdf-converter","vdf-parser"],"created_at":"2025-01-25T19:12:33.791Z","updated_at":"2025-10-07T11:31:25.977Z","avatar_url":"https://github.com/constup.png","language":"PowerShell","funding_links":["https://ko-fi.com/E1E3VQUK2"],"categories":[],"sub_categories":[],"readme":"= VDF (Valve Data File) converter for PowerShell\n:toc:\n:toclevels: 5\n\n== IMPORTANT NOTE\n\n*Due to GitHub being integrated into Microsoft’s CoreAI division and effectivelly becoming Microsoft’s data source \nfor training Microsoft’s LLMs without attributing or compensating open source authors and projects, this repository \nis now locked until it’s transferred to another platform.*\n\n== Support this tool\n\nlink:https://ko-fi.com/E1E3VQUK2[image:https://ko-fi.com/img/githubbutton_sm.svg[Ko-fi]]\n\n== Description\n\nA basic VDF (Valve Data File) converter for PowerShell. Contains functions which you can use in your own PowerShell scripts\nto convert contents of VDF files to other formats. Outputs `PSObject`.\n\n== How to use\n\nThe file link:src/vdf-converter.ps1[vdf-converter.ps1] has a function:\n\n* `ConvertTo-PSObject` - returns the contents of a VDF file as a PSObject\n\n=== Method 1: Copy a function\n\nYou can simply copy the function you need from link:src/vdf-converter.ps1[vdf-converter.ps1] into your own script and use it.\n\n[NOTE]\n====\nOther utilities in this repository may depend on each other. If you want to simply copy them to your script, keep in\nmind that you'll need to resolve these dependencies. If you don't want to resolve dependencies yourself, use Method 3\nlisted below.\n====\n\n=== Method 2: Copy the source file\n\nCopy the link:src/vdf-converter.ps1[vdf-converter.ps1] file and attach it to your script with:\n\n[source,powershell]\n----\n. (Join-Path $PSScriptRoot ./vdf-converter.ps1)\n----\n\n=== Method 3: Copy the entire suite\n\nTo use this whole suite and all of its features, copy the link:src/[src] directory in your PowerShell project, for\nexample, to `vdf-converter-powershell` directory (relative to where your script is). You can then include whichever source\nfile you need with (example):\n\n[source,powershell]\n----\n. (Join-Path $PSScriptRoot ./vdf-converter-powershell/config-files.ps1)\n----\n\n=== Use\n\nYou can then use it with:\n\n[source,powershell]\n----\n$vdfPSObject = ConvertTo-PSObject -vdfContent $pathToYourVdfFile\n----\n\n== Other features\n\nThis repository contains other useful features. Here is the list of files and functions:\n\n* link:src/config-files.ps1[config-files.ps1] - utilities for various Steam configuration files.\n** `Get-LibraryFoldersVdf` - find and return raw contents of Steam's `libraryfolders.vdf` file, or `$null` if it's not\nfound. Pass this raw contents to a converter function to get a desired data structure.\n* link:src/registry.ps1[registry.ps1] - utilities for Steam registry entries.\n** `Find-SteamDirectory` - finds and returns your Steam installation directory, or returns `$null` if not found.\n\n== Testing\n\nhttps://pester.dev/docs/quick-start[Pester 5.6] is used for unit tests in this project. Please note that Windows is shipped\nwith much older version of Pester. For installation instructions follow the\nhttps://pester.dev/docs/introduction/installation[official guide].\n\nTo run the whole test suite (all available tests) with code coverage, use the link:./pester.ps1[`pester.ps1`] script:\n\n[source,shell]\n----\npwsh .\\pester.ps1\n----\n\nOtherwise, you can run individual tests in terminal by following the instructions in\nhttps://pester.dev/docs/quick-start[Pester quick start guide].\n\n=== Testing conventions\n\n- All tests are located in the link:./tests/[tests] directory or its subdirectories.\n- All test files are following the naming convention `*.Tests.ps1`.\n- Coverage report is available at `./coverage/coverage.xml` (when you run the full test suite, of course);\n\n== External resources\n\n* https://developer.valvesoftware.com/wiki/VDF\n* https://developer.valvesoftware.com/wiki/KeyValues\n\n== Support\n\nIf you like this tool or find it useful, consider buying me a nice cup of coffee. Coffee fuels open source.\n\nlink:https://ko-fi.com/E1E3VQUK2[image:https://ko-fi.com/img/githubbutton_sm.svg[Ko-fi]]\n\n== License\n\nlink:LICENSE[Mozilla Public License 2.0] (also available on Mozilla's website at:\nhttps://www.mozilla.org/en-US/MPL/2.0/[MPL 2.0])\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconstup%2Fvdf-converter-powershell","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fconstup%2Fvdf-converter-powershell","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconstup%2Fvdf-converter-powershell/lists"}