Automate resume & cover letter creation; generate PDFs from .odt templates on the fly while scraping the job post & tracking employer status.

angela c052306584 Gems are appended after automated install 10 months ago
classes 4314e7854a Language added 10 months ago
drivers d859340a53 v22 Gecko driver update 10 months ago
templates 2a9af65818 Initial commit 1 year ago
.gitattributes 2a9af65818 Initial commit 1 year ago
.gitignore 5d749e9203 Update ignore files 1 year ago e4ad222be1 Version info 10 months ago
Gemfile 1f1614a1f8 Selenium support added 1 year ago
LICENSE 2a9af65818 Initial commit 1 year ago 4225a0f1bb Modified info page relative to automation updates 10 months ago
config.yml 238ca3e0fb Simplified default paths 10 months ago
resgen c052306584 Gems are appended after automated install 10 months ago
resgen.gif 5b20861da3 Updated screencap 1 year ago

Resgen: Resume Generator Automation

A Ruby-based application to automate the lengthy steps for writing and dating cover letters and keep track of companies and jobs you've applied to.

Generate PDFs from Libre Office .odt templates on the fly and save a copy of the job posting, all without ever having to leave your terminal!

The only thing Resgen doesn't do for you is actually send the resume (but with some minor tweaks, it could do that, too!)

Resgen in action

Zero technical skill required for use

How it works:

  • Initialize Resgen by navigating to it's directory in your terminal and running ruby resgen
  • Resgen will prompt you for information about your job prospect & even alert you if you've applied there before
  • Based on the information you give Resgen, a customized cover letter with the employer name and current date will be generated and merged with your regular resume, straight from .odt templates; no needing to have to create the PDFs by hand any time you want to update it - Resgen does it for you
  • Resgen also scrapes the job posting and saves a textual copy (and dates the file), so you have a point of reference when you're called in for an interview
  • Saves a copy of your resume to your preferred destination (for easy upload); also saves a copy alongside the job posting scrape for easy reference when reviewing that particular job's application details
  • Generate Reports for weekly, monthly or yearly job applying activity
  • Frequently Asked Questions


To upgrade from a previous version of Resgen, follow the Upgrade wiki

Compatible Operating Systems (64-bit)

(It would work on 32-bit too, I just didn't include the needed drivers to support it, if you are using 32-bit, let me know and support will be added. If you're unsure whether or not your OS is 64/32-bit, it is probably 64-bit.)

Quick install

If you need OS-specific instructions, see the compatible operating systems above for links to detailed steps.

git clone && cd resgen && ruby resgen


  • Ruby >= 2.4.x
  • Ruby gems
  • Libre Office 3.5+
  • Firefox ESR 60+ or Firefox 62+ (Waterfox and prior versions of Firefox are not compatible)

As of Resgen v1.3.0, Ruby Gem dependencies are automatically installed during the initial launch of the application.

Why is Firefox required?


The configuration for the application can be found at config.yml; modify the paths according to your environment.

The template.odt file has examples of the variables you'll need to add to your own cover letter in order for Resgen to automate for you. If you wish to add more fields, do so by modifying the resgen loop in controller.rb and featuring the subsequent [NEW_VARS] in your cover letter template.

For detailed instructions on adding additional fields, see the Custom Fields wiki

Bugs or Issues

Check the Install Help wiki or post an issue on the bug tracker


GPLv2 only

Find this useful?

Please leave feedback or star the repo on Github /