https://github.com/mcmic/workflow_kitinerary

Nextcloud application to automatically convert travel documents into calendar events using KDE itinerary project
https://github.com/mcmic/workflow_kitinerary

nextcloud nextcloud-app nextcloud-workflow

Last synced: 1 day ago
JSON representation

Nextcloud application to automatically convert travel documents into calendar events using KDE itinerary project

• Host: GitHub
• URL: https://github.com/mcmic/workflow_kitinerary
• Owner: MCMic
• License: agpl-3.0
• Created: 2022-09-09T08:01:35.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2025-01-04T16:25:53.000Z (14 days ago)
• Last Synced: 2025-01-04T16:30:49.585Z (14 days ago)
• Topics: nextcloud, nextcloud-app, nextcloud-workflow
• Language: JavaScript
• Homepage:
• Size: 7.65 MB
• Stars: 5
• Watchers: 1
• Forks: 1
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: .github/contributing.md
  • License: COPYING

Awesome Lists containing this project

README

        
# Nextcloud Kitinerary workflow

This app lets Nextcloud automatically convert travel documents to calendar events using KDE itinerary project. By utilizing the workflow engine it allows Nextcloud users to define rules upon which various documents are converted to calendar events. The conversion happens by feeding the source file to the kitinerary-extractor binary.

![Screencast of adding a ticket and seeing it imported](screencasts/add-ticket.gif)

Learn more about workflows on https://nextcloud.com/workflow

## Advices on configuration

Nextcloud flow will not let you select a folder in which to apply the flow, but you can use a tag constraint and it will be checked on parent folders as well.

So the recommended configuration is to select "file updated" and a system tag `travel` for instance.

Then you create a folder tagged `travel`, and you put in this folder the files you want to be analyzed by kitinerary to search for travel documents (may be train tickets, plane tickets, hotel reservations and so on).

![Screencast of recommended configuration](screencasts/add-flow.gif)

## Kitinerary binary

The application ships a statically link binary. If this does not work on your setup, or if you want to use a newer version of kitinerary for better results, you can install kitinerary and make sure kitinerary-extractor binary is in the `$PATH` (most distributions package it in `/usr/lib`, you’ll have to symlink in `/usr/local/bin` or wherever in your path).

## Notifications

When a ticket is imported from a file, you will also get a notification, useful if the file was uploaded from desktop or mobile client, or if you allow other people to upload tickets to the tagged directory.

![Screencast of a notification from the application](screencasts/notification.gif)