{"id":15696178,"url":"https://github.com/grantbirki/cah-generator","last_synced_at":"2025-10-27T09:03:44.166Z","repository":{"id":46131510,"uuid":"426908707","full_name":"GrantBirki/cah-generator","owner":"GrantBirki","description":"A custom Cards Against Humanity generator","archived":false,"fork":false,"pushed_at":"2024-05-16T19:27:30.000Z","size":9679,"stargazers_count":13,"open_issues_count":1,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-04T21:46:03.016Z","etag":null,"topics":["builder","cah","cards-against-humanity","custom","script"],"latest_commit_sha":null,"homepage":"","language":"Ruby","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/GrantBirki.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":"2021-11-11T07:27:17.000Z","updated_at":"2025-02-28T17:19:29.000Z","dependencies_parsed_at":"2024-10-24T02:09:15.963Z","dependency_job_id":"cc2f0e67-e77c-4c29-a26a-e38d010d8532","html_url":"https://github.com/GrantBirki/cah-generator","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/GrantBirki%2Fcah-generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GrantBirki%2Fcah-generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GrantBirki%2Fcah-generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GrantBirki%2Fcah-generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GrantBirki","download_url":"https://codeload.github.com/GrantBirki/cah-generator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252898063,"owners_count":21821547,"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":["builder","cah","cards-against-humanity","custom","script"],"created_at":"2024-10-03T19:08:08.445Z","updated_at":"2025-10-27T09:03:44.084Z","avatar_url":"https://github.com/GrantBirki.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003cimg src=\"./generators/multi-card-output/resources/logo.png\" width=\"500px\"\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003e\u003cp align=\"center\"\u003eCAH Generator\u003c/h1\u003e\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  A custom Cards Against Humanity generator specifically designed around having your cards professionally printed\n\u003c/p\u003e\n\n## Turbo Quick Start ⭐\n\nGenerating your own custom CAH deck:\n\n1. Make sure all the cards you want to generate are up-to-date in the `cards/deck_\u003c#\u003e` folder\n2. Run `script/deck --deck=#` (the number of the deck you want to generate)\n3. Your deck zip will be placed in the `decks/` folder\n\n### Creating a new deck\n\nNeed to create a new deck? No problem! Just run `script/deck --create=#` (the number of the deck you want to create)\n\nFrom here you can now edit the `.txt` files in the `cards/deck_\u003c#\u003e` folder to add your own cards.\n\n## Editing Cards 📝\n\nHere is some brief info on creating your own cards:\n\n- Edit one line at a time seperated by a new line in the `cards/deck_#/` directory\n- `black.txt` controls the black cards to generate\n- `white.txt` controls the white cards to generate\n- `info.txt` controls meta data about the deck (e.g. the name of the deck, version, etc)\n\n\u003e Usable double quotes: `“”`\n\n### Custom Card attributes\n\nHere are a few quick custom card attributes that you can add to your cards:\n\n- `{{1}}` - Ads the `custom_img_1` to a card\n- `{{2}}` - Ads the `custom_img_2` to a card ... etc\n- `[[gears]]` - Ads the `gears` image to a card\n- `[[2]]` - Ads the `draw 2` image to a card\n- `[[3]]` - Ads the `draw 2 pick 3` image to a card\n\n\u003e Note: to add a custom card image, drop the image file into the `generators/single-card-output/custom_img/` folder\n\n### About `info.txt`\n\nAn example of the `cards/info.txt` looks like the content below:\n\n```text\nname = Beans Against Humanity\nshort_name = BAH\nversion = 1\ncustom_img_1 = bean.png\ncustom_img_2 = bean.png\ncustom_img_3 = bean.png\ncustom_img_4 = bean.png\ncustom_img_5 = bean.png\n```\n\nIn this case, the custom deck will have the following:\n\n- `Beans Against Humanity` as the name instead of `Cards Against Humanity`\n- `BAH` as the identifier instead of `CAH`\n- `1` as the game deck version\n\nNote: If you do **not** want to use the info file, set all the values to `none` in the text file like so:\n\n  ```text\n  none\n  none\n  none\n  ```\n\n\u003e Important: Make sure your `info.txt` files does not have an ending new line\n\n## Generating Cards ⚙️\n\n- Generate all cards as individual image files (aka `generators/single-card-output/` code)\n\n  This is the ideal option for printing cards since many websites need you to individually upload each card that you want to print\n\n  ```text\n  script/deck --create=#\n  ```\n\n## Note about the code\n\nThis code is unbelievably hacky, gross, and terrible.. but it works.\n\n\u003cdetails\u003e\n  \u003csummary\u003eOriginal Documentation\u003c/summary\u003e\n\n## Introduction\n\n**CAH Generator** is a card generator for the game [_Cards Against Humanity_](https://cardsagainsthumanity.com/), a party game for horrible people.\n\nThis generator enables you to:\n* Generate cards using various formats and styles (more information below).\n* Include your own CAH game. For example, if your game is a CAH fork called ***Ysabel Against Humanity***, you can have your own watermark!\n* Include game version.\n* Automatic PICK and DRAW for black cards.\n* Special cards.\n\n## Use\n\nYou need to have **Ruby** installed, at least 2.5. Then you can, from your console:\n\n```\nruby generator.rb\n```\n\nBy default, a help message will be displayed. Follow the instructions for more.\n\n## Generator features\n\nThe generator works using three files:\n* `white.txt`, the white cards file.\n* `black.txt`, the black cards file.\n* `info.txt`, the game info file, where you can specify the name of your game and, optionally, the game version.\n\n### Info file\n\nIf the info file is available, the generator will introduce your game name in every card. Refer to the help text for more information on this file's format.\n\n### White and black cards\n\nEach card must be in one line. Zero-length lines will be ignored, but lines containing spaces will be turned into blank cards.\n\nInserting `((_))` on any line will generate a special card, that has as icon the character `_` (i.e., for _warning_ cards, put `((!))`).\n\nThe generator has **PICK 2 and PICK 3 detection**, but you can manually insert them by adding `[[2]]` or `[[3]]` at the beggining or the end of the line.\n\nCard text can be **formatted** using HTML-like tags. The supported tags are:\n\n- `\u003cb\u003e\u003c/b\u003e` - bold text\n- `\u003ci\u003e\u003c/i\u003e` - italic text\n- `\u003cu\u003e\u003c/u\u003e` - underlined text\n- `\u003cstrikethrough\u003e\u003c/strikethrough\u003e` - strikethrough text\n- `\u003csub\u003e\u003c/sub\u003e` - subscript text\n- `\u003csup\u003e\u003c/sup\u003e` - superscript text\n- `\u003cbr\u003e` - line break\n- `\u003ccolor rgb=\\\"#0000ff\\\"\u003e\u003c/color\u003e` - set text color\n- `\u003cfont name=\\\"Font Name\\\"\u003e\u003c/font\u003e` - set text font\n\n### Card sizes\n\nYou can specify different card sizes:\n\n* **Large:** cards of size 2.5\" x 3.5\"\n* **Small:** cards of size 2\" x 2\"\n\n## Credits\n\nThis project is a fork of [Bigger, Blacker Cards](https://github.com/bbcards/bbcards). (kinda)\n\n## Disclaimer\n\nThis site is not affiliated with nor endorsed by Cards Against Humanity, LLC. Cards Against Humanity is a trademark of Cards Against Humanity LLC. Cards Against Humanity is distributed under a Creative Commons BY-NC-SA 2.0 license - that means you can freely use and modify the game but aren't allowed to make money from it without the permission of Cards Against Humanity LLC.\n\nDon't use this tool to infringe anyone's intellectual property. Do NOT just plug in the text for existing non-public card packs, that Cards Against Humanity, LLC is selling. That's just not cool. Instead, go to http://www.cardsagainsthumanity.com, and buy their stuff. They made an awesome game, they deserve your money. This tool is for making your own cards, not theirs. That's why there's an option to make big 2.5\"x3.5\" cards -- that way you can print your own custom cards that are the same size as the official, purchased cards, so they can be used together.\n\n\u003c/details\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrantbirki%2Fcah-generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgrantbirki%2Fcah-generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrantbirki%2Fcah-generator/lists"}