{"id":18602915,"url":"https://github.com/fireisgood/limbus-image","last_synced_at":"2025-10-26T12:38:12.285Z","repository":{"id":215943220,"uuid":"740094688","full_name":"FireIsGood/limbus-image","owner":"FireIsGood","description":"Generates tier-maker style images of all sinners.","archived":false,"fork":false,"pushed_at":"2024-09-07T00:10:44.000Z","size":94463,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-25T03:33:45.483Z","etag":null,"topics":["command-line-tool","limbus-company"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FireIsGood.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2024-01-07T14:09:54.000Z","updated_at":"2024-09-07T00:10:50.000Z","dependencies_parsed_at":"2024-09-07T02:49:05.202Z","dependency_job_id":null,"html_url":"https://github.com/FireIsGood/limbus-image","commit_stats":null,"previous_names":["fireisgood/limbus-image"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FireIsGood%2Flimbus-image","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FireIsGood%2Flimbus-image/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FireIsGood%2Flimbus-image/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FireIsGood%2Flimbus-image/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FireIsGood","download_url":"https://codeload.github.com/FireIsGood/limbus-image/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247914303,"owners_count":21017297,"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":["command-line-tool","limbus-company"],"created_at":"2024-11-07T02:12:50.895Z","updated_at":"2025-10-26T12:38:07.243Z","avatar_url":"https://github.com/FireIsGood.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Limbus Image\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"./img/limbus-image-image.png\" alt=\"\" height=\"320\" /\u003e\n\u003c/p\u003e\n\n\u003e This odyssey had its purpose.\n\nA CLI image generator to make Tier List style images of all the sinners. It\nworks relative to a `config.toml` file with folders for the assets (overlays),\ninputs (sinner images in sub-directories), and outputs (sinner images but in a\nflat directory).\n\nIf you're just here for a tier list website link, check out the [Tier Maker page](https://tiermaker.com/create/limbus-company-identities-16617387).\n\nThe images are stored in a specific directory structure relative to the TOML\nfile as follows:\n\n```text\n/\n├── asset/\n│   ├── gradient_small.png     # Overlay for 1 line of upper text\n│   ├── gradient_large.png     # Overlay for 2 lines of upper text\n│   ├── 0.png                  # 0 id border\n│   ├── 00.png                 # 00 id border\n│   └── 000.png                # 000 id border\n├── input/\n│   └── [sinner_name]/\n│       └── id/\n│           └── [id_name].png  # Identity name matching the config\n├── output/\n│   └── id/                    # Identity images\n│       └── [sinner_number]_[sinner_name]_[id_number]_[id_name].png\n└── config.toml\n```\n\nNotably, sinners have an `id/` folder in the case that this project is expanded\nto include EGOs. The output is flat to make copying easier as all of the images\nare prefixed by the sinner and therefore do not need separate folders.\n\nImages will be generated to have a different border based on their rarity and a\ngradient behind the text is expanded for names with more than one line.\n\n\u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"./img/limbus-image-preview-smaller.png\" alt=\"\" /\u003e\n\u003c/div\u003e\n\u003cp align=\"center\"\u003eSinners of all rarities\u003c/p\u003e\n\nThis was made because it seems the tier list maker website hasn't been updated\nin a while.\n\nIf you see any errors, that's totally on me. I wrote this in like 8 hours when I\nshould have been sleeping. Make an issue or pull request if it bothers you.\n\n## Installation\n\nYou can either install it via `cargo` or compile from the source.\n\n### Installing from Cargo (Recommended)\n\nTo install it via Cargo from [crates.io](https://crates.io/), first ensure you\nhave Cargo installed. You can check with the version command:\n\n```bash\ncargo -V\n```\n\nIf you need to install Cargo, look up a guide on your favorite search engine.\nOnce it's installed, just run the installation command:\n\n```bash\ncargo install limbus-image\n```\n\nThis is basically the same as compiling from the source, but more convenient.\n\nThe binary will be usable as `limbus-image` if Rust is correctly configured in\nyour path. Look it up if you have trouble or something.\n\n### Building From the Source\n\nTo build from the source, clone the repo and run the cargo command:\n\n```bash\ncargo build --release\n```\n\nThe binary will be created at `./target/release/limbus-image`. Use this path\nwhen executing in **Usage** instead of `limbus-image`.\n\n## Usage\n\n### Config file\n\nThe binary requires a configuration [TOML](https://toml.io/en/) file in the\nfollowing format:\n\n```toml\n# Yi Sang is the first sinner by number, so he is first in the file\n\n[[sinner]]\nname = \"Yi Sang\" # Sinner name (for bottom text)\npath = \"yi_sang\" # Path of folder\nid = [\n    { name = \"LCB Sinner\", rarity = 1, image = \"lcb.png\" },\n    { name = \"Seven Association\", rarity = 2, image = \"seven.png\" },\n    { name = \"Blade Lineage Salsu\", rarity = 3, image = \"blade_lineage.png\" },\n    #                                           ^ Image file name\n    #                               ^ Rarity (1 to 3)\n    # ^ Sinner name (some are truncated to not go over 2 lines)\n    ...\n]\n...\n# Repeat for every sinner\n```\n\nThe sinners and IDs should be in the order you wish the images to appear as the\noutputted files have numbers to automatically order them. In the example, I have\nordered the sinners by sinner number and IDs by release order, rarity and then\npreference for tie breakers.\n\nThe images are placed in relative directories to the config file, not from where\nyou execute the command from. The specific locations are explained at the top,\nand but you can check out the `/test` directory to see what I have tested with.\n\n### Generating the Images\n\nAfter updating the `cargo.toml`, run the binary with a path to the config file.\nInput and output directories are inferred based on the folder containing the\nconfig.\n\nIf no location is given, the config will try to target `./config.toml`.\n\nAssuming you just compiled the program and haven't installed it:\n\n```bash\n# Run on `./config.toml` (if it exists)\nlimbus-image\n\n# Run on a specific config file\nlimbus-image ./test/config.toml\n```\n\nThe images will be generated flat in the `./output/id/` directory. They have\nnumbers in the file names to be automatically sorted in sinner and then ID\nrelease order when sorted alphabetically. This is helpful for tools like Tier\nMaker which sort all uploaded images in alphabetical order automatically.\n\nThe format is as follows:\n\n```text\n[sinner_number (padded to 2)]_[sinner_name]_[id_number (padded to 2)]_[id_name].png\n```\n\nThey will look something like this:\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"./img/sinner-names-in-explorer.png\" alt=\"sinner images in a file explorer\"/\u003e\n\u003c/p\u003e\n\n## Limitations\n\nImages are hard coded to be 600 by 600 as font sizes are kind of strange and I\ndon't want to deal with them. I don't have high resolution overlays and the\nprovided images are at a lower resolution so it's not very useful to go past\n600 pixels.\n\n## Contributing\n\nFeel free to add issues or make pull requests regarding new IDs. Remember that\nthe binary needs to be run on the config file in `./test/config.toml` to update\nthe repository's images.\n\n## Disclaimer\n\nThis project is unaffiliated with Limbus Company's creators/distributors. Images\nhave been taken from the **Organized Limbus Company Files** from the\n[ProjectMoon Community Hub](https://discord.gg/pmooncommunityfanhub) Discord\nserver.\n\n## License\n\n[MIT](https://choosealicense.com/licenses/mit/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffireisgood%2Flimbus-image","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffireisgood%2Flimbus-image","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffireisgood%2Flimbus-image/lists"}