{"id":18779446,"url":"https://github.com/zostay/envelopes","last_synced_at":"2025-12-18T01:30:17.900Z","repository":{"id":24321108,"uuid":"27717676","full_name":"zostay/envelopes","owner":"zostay","description":"My solution to my annual Christmas card envelope printing problem","archived":false,"fork":false,"pushed_at":"2016-12-15T03:55:15.000Z","size":933,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-12-29T10:29:22.320Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Perl","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/zostay.png","metadata":{"files":{"readme":"README.mkd","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}},"created_at":"2014-12-08T14:05:37.000Z","updated_at":"2016-12-15T03:55:17.000Z","dependencies_parsed_at":"2022-07-25T09:31:57.460Z","dependency_job_id":null,"html_url":"https://github.com/zostay/envelopes","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/zostay%2Fenvelopes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zostay%2Fenvelopes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zostay%2Fenvelopes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zostay%2Fenvelopes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zostay","download_url":"https://codeload.github.com/zostay/envelopes/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239690672,"owners_count":19681143,"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-11-07T20:20:13.245Z","updated_at":"2025-12-18T01:30:13.798Z","avatar_url":"https://github.com/zostay.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Envelope Printer\n\nThis is my solution to my annual Christmas card printing problem. I have used a\nnumber of solutions over the years, but every year I have to retool it. I do not\nuse a Word Processor very often and when I do I general find their mail merge\ntools to be extremely horrible.\n\nAnyway, my previous solution used a Google Apps script to generate my envelope.\nIt works, but I do not like the formatting available on Google Docs and there is\na\n[bug](https://code.google.com/p/google-apps-script-issues/issues/detail?id=1612)\nthat makes working with images more difficult than I want to bother with working\naround, if a work around is even possible. Docs Scripting also seems to change\nfrom one year to the next, so I have to fix my scripts every year.\n\nSo, looking for another solution, I found [this\nscript](https://github.com/martine/envelope) (HT: @martine) for printing\nenvelopes by generating PDFs directly using the Cairo drawing library. Looked\nlike a good idea, but I do not especially like Python, so I wrote my own version\nin Perl and made it configurable from an external set of files and am releasing\nit here in case someone else finds it useful.\n\n## Installation\n\nThis is only available from github. These are approximately the way I install\nand use it.\n\n    # Common to all\n    git clone https://github.com/zostay/envelopes.git\n    cd envelopes\n\n    # On MacOS X, if you use Homebrew, you can install Cairo like this:\n    brew install cairo\n\n    # On Ubuntu, you can do:\n    apt-get install cairo\n\n    # On Windows, you are on your own. Look here: http://cairographics.org/download/\n\n    # Common to all again (assuming you have cpanm installed)\n    cpanm Cairo Text::CSV_XS YAML\n\nThat is all. I tried the Homebrew version of Cairo first, but it seemed to\ninstall incorrectly. The MacPorts package worked fine.\n\n## Usage\n\nJust to get a sample of what this looks like, run:\n\n    ./envelopes settings.yml sendto.csv output.pdf\n\nA file named `output.pdf` will be generated (if there are no errors reported)\nand should contain a single sample envelope.\n\nTo generate your own envelopes you need to modify the `settings.yml` file with\nyour own envelope size and return address. You can tweak the settings in it to\nmodify the font used, the size of the return address and to address, and the\nposition of these on the envelope.\n\nYou may want to locate your own PNG file to use in the return address or just\ndelete the provided one (or remove the `return_png` setting in `settings.yml`)\nif you do not want a picture on your envelope.\n\nFinally, you will need a CSV file containing all the addresses. The file used is\nformatted in 5 columns: name, address, city, state, zip. If your addresses are\nformatted differently, you will just need to modify the program itself or\nreformat your addresses.\n\nOnce you have your CSV file and settings setup, run command above with your\nfiles and you are done.\n\n## Copyright \u0026 License\n\nCopyright 2014 Andrew Sterling Hanenkamp.  This software project is available\nunder the Artistic 2.0 license (or GPL). You may distribute or modify this code\nunder same terms as Perl itself. The image file provided with this program as a\nsample is in the public domain and was retrieved from [pixaby.com](pixaby.com).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzostay%2Fenvelopes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzostay%2Fenvelopes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzostay%2Fenvelopes/lists"}