Skip to content

Keep track of jobs you've applied to, automate resume & cover letter creation; generate PDFs from .odt templates on the fly while scraping the job post and tracking employer status.

License

Notifications You must be signed in to change notification settings

angela-d/resgen

Repository files navigation

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

Aside from knowing how to run a command line application, of course.

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

Upgrading

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):
curl -sSL https://get.rvm.io | bash -s stable

See what verion of Ruby you're running:

rvm current

If you're at least v2.7, you're ready for Resgen!

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

git clone https://github.com/angela-d/resgen.git && cd resgen && ruby resgen

Dependencies

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

  • Ruby v2.7.x
  • Ruby gems (typically installed with Ruby, by default)
  • Libre Office 7.0.42+
  • Firefox/Firefox ESR 91.8+


Customizing

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

License

GPLv2 only

About

Keep track of jobs you've applied to, automate resume & cover letter creation; generate PDFs from .odt templates on the fly while scraping the job post and tracking employer status.

Topics

Resources

License

Stars

Watchers

Forks

Languages