https://github.com/bergercookie/tw2vikunja
TW ➡️ Vikunja conversion script
https://github.com/bergercookie/tw2vikunja
Last synced: 8 months ago
JSON representation
TW ➡️ Vikunja conversion script
- Host: GitHub
- URL: https://github.com/bergercookie/tw2vikunja
- Owner: bergercookie
- License: mit
- Created: 2025-03-10T08:27:48.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-03-10T08:52:17.000Z (over 1 year ago)
- Last Synced: 2025-10-02T06:38:34.600Z (8 months ago)
- Language: Python
- Size: 99.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# `tw2vikunja`
Easily convert your [`Taskwarrior`](https://taskwarrior.org/) tasks to
[`Vikunja`](https://vikunja.io) tasks.
## Installation
This script is currently not available on PyPi (PRs to convert it to a proper
package and upload to PyPI are more than welcome). To install it, just download
the `tw2vikunja.py` script somewhere locally and, assuming you have
[`uv`](https://github.com/astral-sh/uv) installed locally, just execute the
script
```sh
/path/to/tw2vikunja.py
```
This will install any dependencies of the `tw2vikunja.py` script (at the time of
writing only the `pyperclip` package), in a dedicated virtual environment and
will execute the script in that environment.
Alternatively, you can also install the dependencies manually and execute the
script directly:
```sh
pip install pyperclip
python3 -m /path/to/tw2vikunja.py
```
## Usage
You can find some usage examples by running the script with the `--help` flag:
- Get all the tasks from the pending `taskwarrior` database and convert them to
`Vikunja` tasks (doesn't include `+WAITING` tasks):
```sh
task status:pending export | tw2vikunja.py"
```
- Get all the tasks from the `myproject` project and convert them to `Vikunja`
```sh
task pro:myproject export | tw2vikunja.py"
```
- Get all the tasks from the `myproject` project and convert them to `Vikunja`,
but skip converting to the local timezone:
```sh
task pro:myproject export | tw2vikunja.py --skip-convert-tz"
```
- Get all the tasks from the `myproject` project and convert them to `Vikunja`,
but skip adding any tags:
```sh
task pro:myproject export | tw2vikunja.py --skip-tags"
```
Commands like the above (unless a relevant filter is applied) should create a
formatted output, one line per task, which can be copy-pasted in the `Vikunja` task
addition prompt so that the tasks are added to the `Vikunja` database. To
facilitate the pasting, the said output is automatically added to the clipboard
(unless the `--skip-copy` flag is set).
### Example output
```sh
task pro:run export | tw2vikunja.py
```
The above should create an output similar to the following, with `taskwarrior` tags
converted to `*{tag}` and `taskwarrior` projects converted to `+{project}`.
Dates are written as `MM/DD/YYYY` and times as `at HH:MM`:
```txt
How many days to stay there? +paris *remindme 03/11/2025 at 00:00
Book travel tickets +paris *remindme 03/12/2025 at 00:00
Book for holiday on Thursday, Friday and Monday +paris
Book airbnb +paris *remindme 03/13/2025 at 00:00
Register for marathon 03/14/2024 at 14:00 +paris
```
The output can be copy-pasted to the `Vikunja` prompt:
And this is how it looks after the tasks are added:
### Notes
- Projects specified in the `Vikunja` prompt have to exist beforehand in `Vikunja`
otherwise this information is discarded.