{"id":20959506,"url":"https://github.com/djlechuck/fa-updater","last_synced_at":"2026-04-20T16:05:38.554Z","repository":{"id":153988645,"uuid":"594532627","full_name":"DjLeChuck/fa-updater","owner":"DjLeChuck","description":"FA updater is a simple tool that will allow you to keep your FA files up to date.","archived":false,"fork":false,"pushed_at":"2023-02-08T09:00:43.000Z","size":128,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-13T06:41:24.815Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","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/DjLeChuck.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":"2023-01-28T20:51:35.000Z","updated_at":"2023-01-28T20:51:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"6a70975e-1321-4b2e-b140-93bcaf4367b6","html_url":"https://github.com/DjLeChuck/fa-updater","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/DjLeChuck/fa-updater","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DjLeChuck%2Ffa-updater","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DjLeChuck%2Ffa-updater/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DjLeChuck%2Ffa-updater/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DjLeChuck%2Ffa-updater/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DjLeChuck","download_url":"https://codeload.github.com/DjLeChuck/fa-updater/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DjLeChuck%2Ffa-updater/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28101486,"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","status":"online","status_checked_at":"2025-12-28T02:00:05.685Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-11-19T01:54:49.506Z","updated_at":"2025-12-28T16:43:30.757Z","avatar_url":"https://github.com/DjLeChuck.png","language":"Go","funding_links":["https://www.patreon.com/posts/56375276"],"categories":[],"sub_categories":[],"readme":"# FA Updater\n\nFA updater is a simple CLI tool that will allow you to keep your FA files up to date. It will analyze the versions you\nhave and check if more recent ones exist in order to download them easily.\n\n## Installation\n\nGo to the [latest release](https://github.com/DjLeChuck/fa-updater/releases/latest) page and download the version for\nyour computer:\n\n* macOS:  `xxx_darwin_amd64.tar.gz`\n* Linux: `xxx_linux_amd64.tar.gz`\n* Windows: `xxx_windows_amd64.zip`\n\nThen, extract the archive where you want. You should see a new `fa-updater` file which is the tool executable.\n\n## Usage\n\nOpen up your favorite terminal application and go to the directory containing the `fa-updater` executable.\n\nThen, you can execute it without argument to see if it's working:\n\n```bash\n$ ./fa-updater \nFA updater is a simple tool that will allow you to keep your FA files up to date. It will analyze the versions you have and check if more recent ones exist in order to download them easily.\n\nFirst, be sure to define the directory which contains your assets (fa-updater setDirectory), then launch the update process (fa-updater updateAssets).\n\nUsage:\n  fa-updater [command]\n\nAvailable Commands:\n  help         Help about any command\n  setDirectory Define the directory which contains your files\n  updateAssets Launch the update process\n  updateTokens Update all tokens\n\nFlags:\n      --config string   config file (default is $HOME/.fa-updater.yaml)\n  -h, --help            help for fa-updater\n  -v, --version         version for fa-updater\n\nUse \"fa-updater [command] --help\" for more information about a command.\n```\n\n### Available Commands\n\n#### help\n\nBy default, it shows the same thing as running without argument. However, if you add the name of another command, then\nyou will see the help of this command (eg. `./fa-updater help setDirectory`).\n\n#### setDirectory `[type]` `[path]`\n\nDefine the directory which contains your files.\n\n`[type]` can be one of the following:\n\n* `dungeondraft`: will be used by the `updateAssets` command to get newer versions if exists,\n* `tokens`: will be used by the `updateTokens` command to get newer versions if exists.\n\n`[path]` should target an existing directory.\n\nBy default, you cannot override a directory already configured, an error message will be shown telling you to add the\n`--force` flag (short version `-f`) to do it:\n\n```bash\n$ ./fa-updater setDirectory dungeondraft /path/to/da_assets\n2023-02-04T10:23:15+01:00 | INFO  | The directory is already configured: /path/to/dungeondraft/ForgottenAdventures/\n2023-02-04T10:23:15+01:00 | INFO  | Please, use the flag --force flag if you want to override the configuration\n$ ./fa-updater setDirectory dungeondraft /path/to/da_assets --force\n```\n\n#### updateAssets\n\nLaunch the update process to compare the latest available packs with the ones in your assets' directory. It will also\ntake care of the pre-generated thumbnails.\n\nFirst, you will need to get the Patreon page content, then give your Patreon session's cookie in order to be able to\ndownload the files.\n\n\u003cdetails\u003e\n\u003csummary\u003eView usage details\u003c/summary\u003e\n\n```bash\n$ ./fa-updater updateAssets\n2023-02-04T10:45:45+01:00 | INFO  | Go on https://www.patreon.com/posts/56375276 with your browser. Display the source of the page (CTRL+U or ⌘+U) and copy it in the clipboard (CTRL+A and CTRL+C or ⌘+A and ⌘+C), then go back here and press ENTER.\n\n# Go on the page, copy the source code, then press ENTER\n\n2023-02-04T10:45:49+01:00 | INFO  | 35 packs found. Comparing to your assets directory...\n2023-02-04T10:45:49+01:00 | INFO  | There are 2 packs to download.\n2023-02-04T10:45:49+01:00 | INFO  | Please, look at the cookies on the Patreon page and copy the value of the one named \"session_id\" in the clipboard (CTRL+C or ⌘+C), then press ENTER. It should looks like a random string: LC2A4j7WAJe4cjR5Oeicycf4YmlEfQsNB_yqwYiWuh8\n\n# Go on the page, copy the cookie value, then press ENTER\n\n2023-02-04T10:46:09+01:00 | INFO  | Downloading FA_Assets_N_v3.02.dungeondraft_pack...\n2023-02-04T10:46:09+01:00 | INFO  | 200 OK\n2023-02-04T10:46:10+01:00 | INFO  | Download saved to /path/to/dungeondraft/ForgottenAdventures/FA_Assets_N_v3.02.dungeondraft_pack\n2023-02-04T10:46:09+01:00 | INFO  | Downloading FA_Assets_O_v3.01.dungeondraft_pack...\n2023-02-04T10:46:09+01:00 | INFO  | 200 OK\n2023-02-04T10:46:10+01:00 | INFO  | Download saved to /path/to/dungeondraft/ForgottenAdventures/FA_Assets_O_v3.01.dungeondraft_pack\n2023-02-04T10:46:10+01:00 | INFO  | Checking thumbnails...\n2023-02-04T10:46:10+01:00 | INFO  | Thumbnails processing done.\n```\n\n\u003c/details\u003e\n\n##### Why such a complicated process?\n\nConcerning the first step and sadly for us, Patreon is using Cloudflare to protect access of their website. Because of\nthis, it's impossible to automatically crawl the page content, it must be a human action.\n\nAs it concerns the cookie, it's necessary to be allowed to download the Patreon files. This cookie is used to\nidentificate yourself as a valid user which has access to them.\n\n#### updateTokens\n\nLaunch the update process to compare the latest available tokens with the ones in your tokens assets directory.\n\nYou will need to give your Patreon session's cookie in order to be able to download the files.\n\n\n\u003cdetails\u003e\n\u003csummary\u003eView usage details\u003c/summary\u003e\n\n```bash\n2023-02-04T11:05:29+01:00 | INFO  | Please, look at the cookies on the Patreon page and copy the value of the one named \"session_id\" in the clipboard (CTRL+C or ⌘+C), then press ENTER. It should looks like a random string: LC2A4j7WAJe4cjR5Oeicycf4YmlEfQsNB_yqwYiWuh8\n\n# Go on the page, copy the cookie value, then press ENTER\n\n2023-02-04T11:05:36+01:00 | INFO  | Processing page 1...\n2023-02-04T11:05:36+01:00 | INFO  | Downloading Creature Tokens – Pack 42...\n2023-02-04T11:05:37+01:00 | INFO  | 200 OK\n2023-02-04T11:05:40+01:00 | INFO  | Download saved to /tmp/Creature Tokens – Pack 42\n2023-02-04T11:05:40+01:00 | INFO  | Unzipping Creature Tokens – Pack 42...\n2023-02-04T11:05:42+01:00 | INFO  | Processing page 2...\n2023-02-04T11:05:42+01:00 | INFO  | Processing page 3...\n2023-02-04T11:05:43+01:00 | INFO  | Processing page 4...\n2023-02-04T11:05:44+01:00 | INFO  | Processing page 5...\n2023-02-04T11:05:45+01:00 | INFO  | Processing page 6...\n2023-02-04T11:05:46+01:00 | INFO  | Processing page 7...\n2023-02-04T11:05:46+01:00 | INFO  | Processing page 8...\n2023-02-04T11:05:47+01:00 | INFO  | Processing page 9...\n```\n\n\u003c/details\u003e\n\n##### Why such a complicated process?\n\nThis time, no needs to ask for the code source of the page because links are availables through a RSS feed on the\nForgotten Adventures website itself. However, the cookie is always necessary to be allowed to download the Patreon\nfiles.\n\n## How to contribute?\n\n### Bug report\n\nPlease open an issue: https://github.com/DjLeChuck/fa-updater/issues\n\nYou can also provide a fix via a pull request: https://github.com/DjLeChuck/fa-updater/pulls\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjlechuck%2Ffa-updater","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdjlechuck%2Ffa-updater","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjlechuck%2Ffa-updater/lists"}