{"id":23108576,"url":"https://github.com/venryx/urza-gatherer-scripts","last_synced_at":"2025-04-03T23:14:20.516Z","repository":{"id":89346631,"uuid":"480144569","full_name":"Venryx/urza-gatherer-scripts","owner":"Venryx","description":"Scripts for converting external MTG collection/deck data to a format that Urza Gatherer can import.","archived":false,"fork":false,"pushed_at":"2023-11-15T03:54:13.000Z","size":6053,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-02T05:35:06.878Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Venryx.png","metadata":{"files":{"readme":"README.md","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":"2022-04-10T21:29:09.000Z","updated_at":"2024-01-14T12:47:03.000Z","dependencies_parsed_at":"2023-11-15T04:33:03.647Z","dependency_job_id":"d29c7256-9b53-4024-9d68-149be4086889","html_url":"https://github.com/Venryx/urza-gatherer-scripts","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Venryx%2Furza-gatherer-scripts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Venryx%2Furza-gatherer-scripts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Venryx%2Furza-gatherer-scripts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Venryx%2Furza-gatherer-scripts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Venryx","download_url":"https://codeload.github.com/Venryx/urza-gatherer-scripts/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247092393,"owners_count":20882218,"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":[],"created_at":"2024-12-17T01:28:03.886Z","updated_at":"2025-04-03T23:14:20.496Z","avatar_url":"https://github.com/Venryx.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Urza Gatherer Scripts\n\nVarious scripts for use with the UrzaGatherer app (a card-catalog for the card-game Magic the Gathering).\n\n## General setup/installation\n\n1) Install [NodeJS](https://nodejs.org/en/download) if not already installed. (to check if it's installed: `node --version`)\n2) Clone/download this repo to disk. (\"Code\" button above, \"Download ZIP\", extract)\n\n## Delver Export to Urza Database File\n\nThis function lets you convert external MTG collection/deck data to a format that Urza Gatherer can import.\n\nSupported source formats:\n1) [Delver Lens N](https://play.google.com/store/apps/details?id=delverlab.delverlens), csv export of list.\n\nSupported output formats:\n1) [Urza Gatherer](https://www.urzagatherer.com) database file (.ugs) [for use with its database \"Merge\" function]\n\nNotes:\n* The conversion can only take place due to mapping of card-ids between various systems/databases. Naturally, this can only take place if the UrzaGatherer database that these scripts are referencing are up-to-date enough to include the cards being converted.\n* The copy of the UrzaGatherer card-database used by these scripts is located at: `CardDatabases/UrzaCardDB.json`\n* The urza card-db was last updated: **2023-11-14**\n* If the date above is not recent enough, running the scripts will log warnings for cards it can't identify. If needed/desired, you can update the card-database file yourself, by following the instructions in `CardDatabases/@UrzaCardDB_HowToUpdate.md`.\n\n### Preparation\n\n1) Open your [Delver Lens N](https://play.google.com/store/apps/details?id=delverlab.delverlens) Android app.\n2) Click into the List you want to export.\n3) Press the \"Export\" icon in the top toolbar.\n4) Press the \"Create CSV file\" option.\n5) Ensure that the `MultiverseID` and `TCGPlayer productID` fields are enabled for export in the export settings. (along with `QuantityX` and `Name`, which are enabled by default)\n6) Press \"Download\"; your csv file will be exported to the standard \"Download\" folder.\n\n### Usage\n\n1) Do general repo setup/installation. (see earlier section)\n2) Copy the file(s) from \"Preparation\" step 6 into the repo's `ImportFiles` folder. (you can place multiple files, to have them all processed at once)\n3) Open terminal in repo root, and run: `node DelverCSVToUrzaDB.js`\n4) If using Urza Gatherer on Android, copy the generated `OutputFiles/[date+time]_UrzaImport.ugs` file to your Android device.\n5) Go to Urza Gatherer -\u003e Settings -\u003e Merge from a file, press Merge, then select the `[date+time]_UrzaImport.ugs` file.\n6) The contents should now be merged into your collection! (if a card already existed in your collection, the count will be incremented by the amount present in the file)\n\n## Urza Database Transformer\n\nAt the moment, the only operation it supports is decrementing the counts of cards in file A by the counts of cards in file B. (though in the process, it also \"cleans up\" the file, by removing entries that just specify the default value for things, causing unnecessary file bloat)\n\n### Usage\n\n1) Do general repo setup/installation. (see earlier section)\n2) Open terminal in repo root, and run: `node DBTransformer.js decrementCardCounts PATH_TO_BASE_FILE PATH_TO_EXCLUSION_FILE`\n3) A file named `Output_\u003cdate and time\u003e.ugs` will be created in the repo-root; you can then load this into UrzaGatherer in the settings page.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvenryx%2Furza-gatherer-scripts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvenryx%2Furza-gatherer-scripts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvenryx%2Furza-gatherer-scripts/lists"}