Backup repository for imag-pim.org / imag https://imag-pim.org
Find a file
2015-11-30 16:32:15 +01:00
etc Add configuration module 2015-10-26 22:30:15 +01:00
src Add debugging output in storage parser code 2015-11-27 22:18:26 +01:00
.gitignore Initial import 2015-10-18 20:22:23 +02:00
Cargo.lock add dep: glob 2015-11-20 15:33:40 +01:00
Cargo.toml add dep: glob 2015-11-20 15:33:40 +01:00
default.nix Switch to pkgs.rustUnstable, so we do not need to rebuild rustc (wtf?) 2015-11-23 18:28:24 +01:00
LICENSE Add LICENSE file 2015-11-08 17:35:49 +01:00
README.md Add image, video and music modules 2015-11-30 16:32:15 +01:00

imag

Imag is a CLI PIM suite with a nice API-ish commandline interface, so you can integrate it in your tools of coice (Editor, MUA, RSS reader, etc etc).

Modules

All the modules have access to a shared store (which lives in ~/.imag/store/ by default). Files are named after a schema:

~/.imag/store/<module_name>-<hashtype>-<hash>.imag

Where module name is "bookmark" for example. The hashtype is "UUID" by default and the "hash" is a UUID then. Other types are possible as well:

  • SHA1
  • SHA512

for example (though it might not be a good idea to use SHA hashes, see Linking)

Some modules might not want to store content there, for example you don't want to put your icalendar files in there. So the calendar module just crawls through your ical files and puts the scanned meta-information into the store. Of course, if the content of the ical file changes, the store entry does not. It still points (via its JSON content for example) to the same file. So changes are not tracked (We can argue here whether we want to copy the contents to the store for ical and vcard files, but we cannot argue on for example music files).

If a (for example ical-)file gets removed, the store entry gets invalid and has to be garbage-collected.

The current model is not fixed yet. I'm thinking about copying .ical and .vcard, basically all text files, to the store. This is not possible for media files like music or movies, though. Also this is not feasible for documents like .pdf or similar.

Each of the following modules has a short description including a table what core features are required to get it working.

Linking

The UUID/SHA hashes in the file names can be used to connect two store entries. For example, an entry from the wiki could refer to a contact by a UUID, because the file for the contact has a UUID in its name. These UUIDs are constant and should not change.

A link chain like this

Wiki -> Shopping List -> Calendar Entry
        |                       |
        |                       v
        |                       Contact -> Calendar Entry -> Bookmark
        v
        Wiki Entry -> Bookmark

is totally possible. Scenario: You have a Wiki entry of a recipe you like to cook. The recipe is linked to a shopping list, where you want to buy the ingredients. Of course, you want to do this on a specific date (calendar entry). And you want to do this with your Girlfriend, so she (as a contact) is linked to the calendar entry. Her Birthday is linked to her Contact and for her Birthday, you saw something on amazon, so you bookmarked it and linked it to the calendar entry. On the other hand, the Shopping list has links to some other Wiki entry, because it contains Kiwi, and you have notes about Kiwi, how to cook them properly. You saw this on some website, so you linked to the website from your wiki entry, of course.

Bookmarks

Bookmarks should be stored in a simple format:

{ "URL": "https://github.com", "tags": ["ducks", "r", "great"]}

Each file is one bookmark and the filename is a SHA512.

Required core feature Purpose
Filesystem access (RW) Data storage
JSON File backend Data format
Git backend Data sync

Contacts

Contacts are just read and indexed by imag, to create an internal index of them and to be able to refer to.

Required core feature Purpose
Filesystem access (RW) Data access
vcard file format parsing Data access

Calendar

Calendar are just read and indexed by imag, to create an internal index of them and to be able to refer to.

Required core feature Purpose
Filesystem access (RW) Data access
ical file format parsing Data access

Mail

imag should be able to index all your mail and make them accessible through its interfaces, so you can link contacts, calendar entries, wiki pages, todo notes, etc etc. to your mail.

Some of these things (like linking contacts, calendar entries) should be linked automatically.

Required core feature Purpose
Filesystem access (RO) Data access
Maildir file format parsing Data access
mbox file format parsing (later) Data access
Internal storage database Data indexing
JSON File backend Database
Editor calling Editing
Mail-Client calling Editing

Personal Wiki

imag should contain a complete personal wiki software. It should contain of simple markdown files which have a YAML header, nothing too special for the first step.

Required core feature Purpose
Filesystem access (RW) Data access
YAML parsing Data parsing
Markdown parsing Data parsing
Git backend Data sync
Editor calling Editing

Some more ideas:

  • Extract URLs and put them into store as Bookmarks

Todo-List

imag should also contain a full todo-tool. I'm thinking about integrating taskwarrior through a wrapper here.

Required core feature Purpose
Filesystem access (RO) Data access
Taskwarrior backend Data parsing
Git backend Data sync
Editor calling Editing

Shoppinglist

Simply dot-and-tick lists.

Required core feature Purpose
Filesystem access (RW) Data access
YAML parsing Data parsing
Markdown parsing Data parsing
Git backend Data sync
Editor calling Editing
  • Maybe as sub-form of the Todo-List module

Bibliography management

BibTex would be the first step, maybe we should be able to add the actual PDFs here as well... didn't waste too much thoughts on this by now. If we have the PDF data, we need git-annex.

Required core feature Purpose
Filesystem access (RW) Data access
BibTex parsing Data parsing
Git backend Data sync
Git-annex backend Data sync
Editor calling Editing

News (RSS)

Just indexing, reading news is not task of imag and so isn't syncing.

Required core feature Purpose
Filesystem access (RO) Data access
RSS parsing Data parsing
Git backend Data sync

Image

Just indexing photos.

Required core feature Purpose
Filesystem access (RO) Data access
Git-annex backend Data sync
Image metadata reading Data parsing
Linking to other store entries Data Link

Video

Just indexing movies.

Required core feature Purpose
Filesystem access (RO) Data access
Git-annex backend Data sync
Movie metadata reading Data parsing
Linking to other store entries Data Link

Music

Just indexing music.

Required core feature Purpose
Filesystem access (RO) Data access
Git-annex backend Data sync
Music metadata reading Data parsing
Linking to other store entries Data Link

License

This code is released under terms of GNU GPLv2.