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

angela d3fd2edb8d Add RVM note 5 months ago
classes cb9d1b05cc Dependency installer bugfixes 5 months ago
drivers e68ba744c4 v0.27.0 Gecko driver update 5 months ago
templates 2a9af65818 Initial commit 2 years ago
.gitattributes 2a9af65818 Initial commit 2 years ago
.gitignore 2a6aadabda Update ignore files 5 months ago a84c16e1a3 v1.3.1 5 months ago
Gemfile 1f1614a1f8 Selenium support added 2 years ago
LICENSE 2a9af65818 Initial commit 2 years ago d3fd2edb8d Add RVM note 5 months ago
config.yml 238ca3e0fb Simplified default paths 2 years ago
resgen c052306584 Gems are appended after automated install 2 years ago
resgen.gif 5b20861da3 Updated screencap 2 years 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

Linux/Mac users: Using RVM is highly recommended; it allows you to install Ruby in a virtual sense and doesn't rely upon or mess with the Ruby already bundled with your operating system. (no root/sudo required for gem installs, too!)

  • Just be sure to use the compatible Ruby version (see Dependencies section): bash curl -sSL | bash -s stable See what verion of Ruby you're running: bash rvm current If you're between v2.4 and v2.6.5, you're ready for Resgen!

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

git clone && cd resgen && ruby resgen


Companion applications you need installed in order for Resgen to work.

  • Ruby v2.4.x - v2.6.5 (2.7 is incompatible*)
  • Ruby gems (typically installed with Ruby, by default)
  • Libre Office 6.1.5+
  • Firefox/Firefox ESR 78+

*the Selenium webdriver for Firefox has depreciations that will have to be upgraded in order for Resgen to be compatible with Ruby v2.7; this is not a bug in Resgen's code.

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 /