Skip to content
The open and easy way of time management and billing. The official repository is now at:
Ruby JavaScript
Find file
Latest commit 0c691be @peterskeide Add limit 255 to down
Failed to load latest commit information.
app Increase length of time entries notes field to 500
config Added bundler for gem dependency ref:…
db Add limit 255 to down
doc Initial commit of TimeFlux (unfinished)
lib Refactored vacations views and controller to be more restful. Moved m…
private pagination, utf-8 bug in reports, and month view
public Added a department field to user
script Some reporting cleanup and data migration
test Increase length of time entries notes field to 500
vendor/plugins/prawnto Another attempt to fix the pdf + ssl + explorer bug
.gitignore Added bundler for gem dependency ref:…
Gemfile Update version of rake
Gemfile.lock Update version of rake
README.mdown updated readme (github and Showdown doesn´t agree on how to render ma…
Rakefile removed pagination as they didn´t work after update to bundler, and s…



Timeflux is an hour reporting tool built around a normal workflow for a consultant company.

Users register worked hours on activities. For each month they also need to confirm that they are finished registering hours. Registrations on the vacation activity are publicly visible to all users in the vacation view.

Admins manage the activities a user can register on. Activities belong to a project, and projects belong to a customer. At the end of a month admins can view an overview over users to check that all registrations for the month are complete. They can then move on to the billing report where invoices are generated.


For users:

  • Simple hour registration
  • Month overview
  • Public vacation overview

For admins:

  • Billing, user, companies and project reports
  • Simple and advanced search
  • Tagging of activities (for grouping purposes)
  • Easy management of project assignments
  • Easy management of project activities by templates


On Ubuntu linux:

  1. Install git: sudo apt-get install git-core
  2. Install ruby: sudo apt-get install ruby-full build-essential
  3. Install Rubygems
    1. Download latest version of rubygems from rubyforge (
    2. Decompress into suitable directory and, in same directory, execute command: ruby setup.rb
    3. Create softlink: sudo ln -s /usr/bin/gem1.8 /usr/bin/gem
    4. Verify installation: gem -v
  4. Install sqlite3 as your development database: sudo apt-get install sqlite3 libsqlite3-dev
  5. Install rails++: sudo gem install rails rake sqlite3-ruby prawn
  6. Clone the code from GitHub
  7. Install required dependencies (cd to TimeFlux root-directory): sudo rake gems:install
  8. Install test dependencies: sudo rake gems:install RAILS_ENV=test

Getting started

Before testing Timeflux you need to:

  1. Load initial data: rake db:setup
  2. Start the server: ruby script/server
  3. Go to url http://localhost:3000

The seeded data contains two users:

  • user=admin, password=admin
  • user=user, password=user
Something went wrong with that request. Please try again.