{"id":24778207,"url":"https://github.com/marsdevx/ascii2header","last_synced_at":"2026-03-05T18:32:18.012Z","repository":{"id":272042172,"uuid":"911855008","full_name":"marsdevx/ascii2header","owner":"marsdevx","description":"💻🖌️ Add headers with metadata and ASCII art to your code files","archived":false,"fork":false,"pushed_at":"2025-12-25T04:53:49.000Z","size":340,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-26T18:46:00.671Z","etag":null,"topics":["ascii","ascii-art","bash","cli","cli-app","code","command-line","custom","dev","header","header-generator","headers","metadata","open-source","personalize","python","python-script","python3","style","zsh"],"latest_commit_sha":null,"homepage":"","language":"Python","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/marsdevx.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":"2025-01-04T02:58:58.000Z","updated_at":"2025-12-25T04:53:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"c9203305-ced1-41d2-9079-c07e04e1e077","html_url":"https://github.com/marsdevx/ascii2header","commit_stats":null,"previous_names":["marsdevx/ascii2header"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/marsdevx/ascii2header","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marsdevx%2Fascii2header","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marsdevx%2Fascii2header/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marsdevx%2Fascii2header/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marsdevx%2Fascii2header/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/marsdevx","download_url":"https://codeload.github.com/marsdevx/ascii2header/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marsdevx%2Fascii2header/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30142608,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T16:58:46.102Z","status":"ssl_error","status_checked_at":"2026-03-05T16:58:45.706Z","response_time":93,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["ascii","ascii-art","bash","cli","cli-app","code","command-line","custom","dev","header","header-generator","headers","metadata","open-source","personalize","python","python-script","python3","style","zsh"],"created_at":"2025-01-29T08:17:58.208Z","updated_at":"2026-03-05T18:32:17.968Z","avatar_url":"https://github.com/marsdevx.png","language":"Python","readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"imgs/logo.png\" width=\"320px\" alt=\"Logo ASCII header\"\u003e\n\u003c/div\u003e\n\n\u003cbr\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n  [![Last Commit](https://custom-icon-badges.demolab.com/github/last-commit/marsdevx/ascii2header?logoColor=white\u0026labelColor=2C2C2C\u0026label=Last%20Commit\u0026color=8A2BE2\u0026logo=mark-github)](https://github.com/marsdevx/ascii2header/commits/main \"Last Commit\")\n  [![Shell Support](https://custom-icon-badges.demolab.com/static/v1?logoColor=white\u0026labelColor=2C2C2C\u0026label=Shell\u0026message=Zsh%20%7C%20Bash\u0026color=D32F2F\u0026logo=gnu-bash)](https://github.com/marsdevx/ascii2header \"Shell Support\")\n  \u003cbr\u003e\n  [![Languages](https://custom-icon-badges.demolab.com/static/v1?logoColor=white\u0026labelColor=2C2C2C\u0026label=Languages\u0026message=Python%203.13\u0026color=748ADB\u0026logo=file-code)](https://github.com/marsdevx/ascii2header \"Languages\")\n  [![Header Generator](https://custom-icon-badges.demolab.com/static/v1?logoColor=white\u0026labelColor=2C2C2C\u0026label=Header%20Generator\u0026message=File%20Meta\u0026color=F47F42\u0026logo=file-binary)](https://github.com/marsdevx/ascii2header \"Header Generator\")\n  [![Customizable](https://custom-icon-badges.demolab.com/static/v1?logoColor=white\u0026labelColor=2C2C2C\u0026label=Customizable\u0026message=ASCII%20Art\u0026color=009688\u0026logo=file-media)](https://github.com/marsdevx/ascii2header \"Customizable\")\n  [![License](https://custom-icon-badges.demolab.com/static/v1?logoColor=white\u0026labelColor=2C2C2C\u0026label=License\u0026message=MIT\u0026color=00C853\u0026logo=law)](https://github.com/marsdevx/ascii2header/blob/main/LICENSE \"License\")\n\n\u003c/div\u003e\n\n---\n\n# 🖌️ ASCII to Header\n\nThis project is a **command-line** tool designed to add customizable **headers** to your **code** files with **ASCII art** and **file information**. Built with **Python**, this lightweight and **open-source** program makes it easy to **personalize** your files and add a **professional touch**.\n\n*\tCustom **ASCII** art to make **your headers** visually unique.\n*\tAutomatically adds **file-specific** **metadata**.\n*\tBuilt with **Python** for simplicity and **cross-platform** compatibility.\n*\tA great tool for **developers** who want to enhance the **readability** and branding of their **code files**.\n\nAdd style and structure to your code with this powerful and flexible header generator!\n\n---\n\n## 🖼️ Preview\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"imgs/preview.png\" alt=\"Preview\"\u003e\n\u003c/div\u003e\n\n---\n\n## 🛠️ Installation\n\nTo install this project, Launch the Terminal app on your system, and run the commands below. \u003cbr\u003e\n  - If a pop-up appears prompting you to download the Xcode Command Line Tools after the first command, click “Download” and then run the first command again.\n\n1. **Clone repo**\n```bash\ngit clone https://github.com/marsdevx/ascii2header.git ~/ascii2header\n```\n\n2. **Install Python**\n```bash\nbrew install python\n```\n\n3. **Set Up an Alias**\n\n- For Zsh Users\n```bash\necho \"\\nalias ascii2header=\\\"python3 /Users/$(whoami)/ascii2header/ascii2header.py\\\"\" \u003e\u003e ~/.zshrc\nsource ~/.zshrc\n```\n\n- For Bash Users:\n```bash\necho \"\\nalias ascii2header=\\\"python3 /Users/$(whoami)/ascii2header/ascii2header.py\\\"\" \u003e\u003e ~/.bashrc\nsource ~/.bashrc\n```\n\n---\n\n## 🚀 Usage\n\n1. **Add a Header to a Single File**\n\n```bash\nascii2header \u003cfile\u003e\n```\n\n2. **Add Headers to All Files in a Directory**\n\n```bash\nascii2header \u003cdir\u003e\n```\n\n3. **Add Headers to Multiple Files and Directories**\n\n```bash\nascii2header \u003cdir\u003e \u003cfile\u003e \u003cdir\u003e \u003cfile\u003e \u003cfile\u003e\n```\n\n4. **Specify ASCII Art**\n\n```bash\nascii2header \u003cfile\u003e -a \u003cascii\u003e\n```\n\n- Available ASCII Art Options\n  - `anime-girl` \n  - `asteroid`   \n  - `cat`        \n  - `eye`        \n  - `eyes`       \n  - `franxx`     \n  - `gary`      \n  - `gojo`       \n  - `pikachu`    \n  - `rabbit`\n\n---\n\n## ⚙️ Advanced Options\n\n### Add Your Own ASCII Art\n\n1. **Navigate to the ASCII Arts Directory**\n\n```bash\ncd ~/ascii2header/ascii-arts\n```\n\n2. **Add ASCII Art**\n\n- Create a new file inside the ascii-arts directory.\n- Paste your custom ASCII art into the file and save it.\n\n---\n\n## 📋 License\n\nAll the code contained in this repo is licensed under the [MIT License](LICENSE)\n\n```\nMIT License\n\nCopyright (c) 2025 marsdevx\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n```\n\n---\n\n## ⭐ Support\n\nIf you like this project, don’t forget to ⭐ **star** it and **follow** me!  \nYour **support** helps me create more projects. 🚀  \n\n🔗 **Explore more of my work on [GitHub](https://github.com/marsdevx?tab=repositories) and discover other exciting projects!**","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarsdevx%2Fascii2header","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarsdevx%2Fascii2header","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarsdevx%2Fascii2header/lists"}