https://github.com/taviso/stfjson
Convert Lotus Agenda STF files to JSON
https://github.com/taviso/stfjson
lotus ms-dos
Last synced: 3 months ago
JSON representation
Convert Lotus Agenda STF files to JSON
- Host: GitHub
- URL: https://github.com/taviso/stfjson
- Owner: taviso
- Created: 2020-10-21T21:11:21.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2020-10-21T21:19:33.000Z (over 4 years ago)
- Last Synced: 2025-02-09T15:13:48.219Z (4 months ago)
- Topics: lotus, ms-dos
- Language: C
- Homepage:
- Size: 5.86 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# stfjson
This code will attempt to parse the STF format that Lotus Agenda can export to,
and convert it into modern JSON. Lotus Agenda is an old PIM for MS-DOS, it's
unlikely anyone will ever use this code except for me 😂
The intention is to allow you to import Lotus Agenda data into other tools, and
a modern format like JSON has the tools to allow that.
The STF format is (partially) documented in the Lotus manual, "Working with
Definition Files", but a lot of the format is undocumented.
# Building
You need `libjson-c`, then just type `make`
# Usage
## Exporting Agenda Data to STF
In Lotus Agenda, you can either export an agenda file to STF manually:
```
F10 (menu) -> File -> Transfer -> Export
```
Or you can use automatic actions, so that when a new item is assigned to a
category it is automatically exported.
```
F9 (Category manager) -> F6 (Properties) -> Special actions -> Export item
```
## Parsing STF
Now that you have an STF file, you can use a tool like `jq` to query it, and
then import the data to something else.
- Print a list of all items
`$ ./stfjson < transfer.stf | jq '.[].items[].text'`
- Show all items with a due date
`$ ./stfjson < transfer.stf | jq '.[].items[] | select(.categories[].name=="\\When")'`
- Show all items with a due date in the future
`./stfjson < transfer.stf | jq '.[].items[] | { text: .text, due: (.categories[] | select(.name=="\\When") | .value | fromdate) } | select(.due > now)'`
Once you've extracted the data you need from jq, you can pipe it into another
application, like TaskWarrior, todo.sh, mailx, or whatever else.
# Bugs
In the highly unlikely event another human uses this, and you find it doesn't
parse an STF file created by Lotus Agenda correctly, please create an issue.