Software development company founded by Kevin Papst
PHP Command line client for Kimai.
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.
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
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
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 | |
Fixed invoice data format (by language) |
plugin
|
free | |
Grandtotal plugin |
3rd party
|
free | |
Installation & Update support |
support
|
||
Recalculate rates plugin |
plugin
|
free |