free

Pricing for this item
Logo - Keleo

Keleo

Software development company founded by Kevin Papst

Cross platform console client for Kimai
Last update: 01 Jan 2020

PHP Command line client for Kimai.

Features

This command line client should help work Kimai remotely via your favorite shell.

It is based on the PHAR technology, so you need PHP >= 7.3 installed on your machine to use it.

You can find the full documentation at GitHub.

Download and install

I cannot help with windows installs, this is only for Linux and Mac:

curl -LO https://github.com/kevinpapst/kimai2-console/releases/latest/download/kimai.phar
curl -LO https://github.com/kevinpapst/kimai2-console/releases/latest/download/kimai.phar.sha1
sha1sum --check kimai.phar.sha1
rm kimai.phar.sha1
chmod +x kimai.phar
mv kimai.phar /usr/local/bin/kimai

Before using it the first time, you have to create a configuration file, which holds the connection infos for Kimai. By default this config file will be located at ~/.kimai2-console.json:

kimai configuration:create

Make sure the file is only readable for your own user:

chmod 600 ~/.kimai2-console.json

That’s it, you can use Kimai from the command line now, like so:

$ kimai
$ kimai customer:list

By default the configuration file holds credentials for the demo installation … but now its time to target your own Kimai installation! Edit the config file and change the settings: URL, username and API token.

You can find all options in the help:

$ kimai

 _  _____ __  __    _    ___   ____
| |/ /_ _|  \/  |  / \  |_ _| |___ \
| ' / | || |\/| | / _ \  | |    __) |
| . \ | || |  | |/ ___ \ | |   / __/
|_|\_\___|_|  |_/_/   \_\___| |_____|

Kimai 2 - Remote Console version 0.3 2020-01-05 17:56:49 UTC (#55c3766)

Usage:
  command [options] [arguments]

Options:
  -h, --help            Display this help message
  -q, --quiet           Do not output any message
  -V, --version         Display this application version
      --ansi            Force ANSI output
      --no-ansi         Disable ANSI output
  -n, --no-interaction  Do not ask any interactive question
      --profile         Display timing and memory usage information
      --csv             Render raw data instead of styled tables
  -v|vv|vvv, --verbose  Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug

Available commands:
  active         List active timesheets
  configuration  Handle the Kimai configuration file
  help           Displays help for a command
  list           Lists commands
  start          Starts a new timesheet
  stop           Stops running timesheets
  version        Show the Kimai version
 activity
  activity:list  List available activities
 customer
  customer:list  List available customers
 project
  project:list   List available projects
 self
  self:check     Checks for available updates
  self:rollback  Rollback to the latest available version
  self:update    Update to the latest available version

All items by Keleo

Audit-Trail plugin

Records detailed change/audit logs for timesheets, customers, projects and activities and displays them in a per-item timeline.
plugin
29€

Custom-fields plugin

Create free configurable additional (optional and mandatory) fields for timesheets, customers, projects and activities in various formats.
plugin
49€

Expenses plugin

Keep track of your expenses based on a customer, project and activity. These expenses can be categorized and included in your invoices.
plugin
49€

Kiosk plugin
New

Attendance time-tracking in an environment, where the user has no access to Kimai (eg. in a warehouse) by using a barcode or RFID scanner to start and stop timesheets.
plugin
199€

Task management plugin

Create tasks, start/stop/pause them, assign them to users and teams - a todo-list management plugin that is connected to your time-tracker and adds two new dashboard widgets
plugin
49€
Console client (PHAR)
client
free
Custom CSS plugin
plugin
free
Custom plugin development
development
support
Fail2Ban plugin
plugin
free
Grandtotal plugin
3rd party
free
Installation & Update support
support
Recalculate rates plugin
plugin
free