Move from Kimai to Hourbun
By Fred Wu, maker of Hourbun · Checked · Report a mistake
The short answer
Export your Kimai time as CSV: open Time Tracking, Export, filter the timesheet records, and choose CSV or a saved template. In Hourbun, open Settings, Import, choose Another app (CSV) and upload the file: Hourbun proposes a column for each field, matches each person to a teammate and shows a preview before it imports anything.
Export your time from Kimai#
- In Kimai, open Time Tracking, then Export.
- Filter the timesheet records to export.
- Choose CSV, or a saved template, and download the file.
A template of your own chooses the columns of the file and, for CSV, its separator: a comma or a semicolon. Hourbun reads both.
Import the file into Hourbun#
- Open the import. In Hourbun, open Settings, then the tab Import, and choose Another app (CSV) under "Import from".
- Upload the file. Drop the
.csvfile on the field, or use Choose files, then press Read the file. The field takes.csvfiles, or one.zipfile of them: save an Excel file as CSV first. Hourbun reads a file in UTF-8, with a comma, a semicolon or a tab between the columns. - Check the columns. Hourbun proposes a column of the file for each field. The Date, the Project and the Hours are required; a file with no hours can give a Start time and an End time of the same day instead. Check the formats of the dates and the hours (decimals,
H:MMorH:MM:SS), and choose a client for the rows with no client. The preview shows the first 5 rows as Hourbun reads them, and marks a value that it cannot read. - Choose what comes. An Import from date leaves out the rows before it.
- Match the people. Choose the teammate of each person of the file: you, a teammate of the workspace, or a new teammate with an email address. A new teammate is not invited and gets no email.
- Check the file. Press Check the file. Hourbun runs the whole import and rolls it back, then shows the preview: what comes over, the money check and what needs you. A Must fix item stops the import: correct the file, then upload it again.
- Import. Press Import and confirm.
The columns to check#
Kimai's help does not list the exact column names of its export. The mapping step proposes a column for each field from its name, as for a file of any app: check each proposal, and choose the column yourself where Hourbun proposes none.
Kimai's preference "Use decimal duration in export" switches the duration of its default templates between two versions, a duration such as 1:15 and a decimal such as 1.25: Hourbun reads both, so choose the matching format in the mapping step.
Bring more than the time#
The mapping step is for the file of time entries. The files of clients, projects, expenses and past invoices have no mapping step: they need the columns of Hourbun's format guide. Under the upload field, Download the format guide gives it. The guide ends with a prompt: give it and your Kimai exports to an AI agent, and the agent converts them into these files. Upload them with the file of time, or all of them in one .zip file.
Kimai exports its expenses as Excel, PDF or HTML: save the Excel file as CSV before you give it to the agent.
What does not come over#
- A column that no field of the mapping step takes, such as tags: it stays in the file.
- Receipt files of expenses, estimates and draft invoices: a CSV file has no place for them.
- Cost rates: an imported entry has no cost rate.
- Later changes in Kimai: an import copies the file as it was exported, and is no sync.
Questions
Questions and answers
Can I move from Kimai to Hourbun?
Yes. Export the Kimai timesheets as CSV from Time Tracking, Export, and upload the file in Hourbun in Settings, Import, Another app (CSV). Hourbun reads a comma or a semicolon as the separator, and shows a preview before the import.
Does Hourbun read Kimai durations like 1:15?
Yes. Hourbun reads hours as decimals (1.25), as H:MM (1:15) or as H:MM:SS, so either setting of Kimai's "Use decimal duration in export" works. Choose the format of the file in the mapping step.
Does Hourbun keep my Kimai time in sync?
No. A CSV import copies the Kimai export as it is. The next import of a newer export proposes the day after the latest entry of the last import as its Import from date, and an entry with the teammate, the project, the task, the date, the hours and the note of an entry of the workspace is not added again.
Sources
The export steps of Kimai follow its own help pages, read on 16 November 2026: