ocranizer
ocranizer
Simple fast CLI organizer.
Installation
First make
or shards build pim
. Next you need to copy binary file into one of directories in PATH
variable.
You can use make install
or sudo cp -vn bin/pim /usr/bin
.
Note: I'm not Mac user so this can be not Mac (or Unix) compatible because of user home path.
Usage
Main types - entities
Event
is a time range when something occurs. It's described by time and the time defines when Event
occurs.
Todo
is a task which must be completed. It can be described by time. Todo
can have (but not need to have) deadline - time_to
and can be started after time point - time_to
.
Event
and Todo
is an Entity
.
Command parameters styles
Destructive actions
Most destructive commands are uppercase. For example if you want to search an Event
you use pim -e
, but if you want to add you should use uppercase E
like pim -E
.
Parameters
There is predefined list of possible parameters. They can be used to filter, create, update and delete depends on command.
Theese parameters are:
-n
or--name
- name/title-i
or--id
- unique identifier of anEntity
-a
or--from
- start time-z
or--to
- end time-d
or--day
- only for filtering for particular day-p
or--place
- place-c
or--category
- category, just oneString
likework
,private
-g
or--tags
- tags,Array(String)
but you should type them in oneString
separated with coma,
-c
or--desc
- longer description ofEntity
, totally optional-u
or--user
- other peopleEntities
-b
or--url
- external http link forEntity
What is an User
Imagine you have friend you often travel with. You can add his blocking events here. You can later get his all events and know when he is available.
Filter params
Parameters described above behaves differently when used in create and filter.
-n
or--name
- substring, ignore case-i
or--id
- substring, ignore case-a
or--from
- filter within range-z
or--to
- filter within range-d
or--day
- filter overlapping day-p
or--place
- substring, ignore case-c
or--category
- exact, case-g
or--tags
- exact, case-c
or--desc
- substring, ignore case-b
or--url
- substring, ignore case-u
or--user
- described below
User filter
-u ""
- default filter only ownEntity
-u "rest"
- filter only other (not blank) users-u "all"
- show all: self and other-u "joe"
- show onlyjoe
entities
Create params
To create Entity
you need to specify enough required parameters. Todo
require only name
but Event
require name
, time_from
and time_to
.
Example: pim -T "Clean room"
You can specify more information (except the id
which is generated automatically).
Example: pim -T "Clean room" -c "apartment"
Repeated
By adding --monthly
or --yearly
you can create repeated entities. This is a new feature and interface is not fully ready yet.
Add Event
pim -E "Doctor appointment" -a "2017-02-05 12:00" -z "1 hour" -g "doctor" -c "appointment"
Result:
Doctor appointment
2017-02-05 12:00 -> 2017-02-05 13:00
category: appointment
tags: doctor
Id: 20170124131927368
Everything is stored at ~/.ocranizer.yml
HTML output
Just add -H
and it will generate HTML calendar and open it in default browser. Calendar file is located at ~/.ocranizer.yml.html
.
Help
pim -h
will tell you about all possible parameters.
Human time form
Please check here for more details.
You can use absolute values like:
2017-10-10
for full day,10-10
for full day with current or next year (no past time)2017-10-10 12:40
for exact,13:40
for current day
or relative values like:
1 week
- 1 week from now or event's time fromprev 1 hour
- 1 hour before
Development
- Not allow create entity when
time_from
>time_to
-
time_to
if typed as hours uses date fromtime_from
- Interpret fullday as 0:00 - 23:59
- Show entity id at details
- TEST, TEST, TEST!!!
- Test command parser
- Delete action
- Postpone - update but easier
- Add search macros, ex:
work_today
show all withwork
category and proper time ranges,incoming
with entities till2 days
- Add create macros
- Update
id
to make it always unique forEvent
andTodo
- Add events, todos using command line interface
- Inteligent time parser: full, partial, words like tommorow, +1 day, +1 week
- List of upcoming events
- Edit existing events
- Integrare output with remind
- Render HTML output
- Saving with backup
- Add limit filter
- Add
priority
: low, regular, urgent, important - When adding full day event assume
time_to
is end of day oftime_from
if missing - Repeated entities
- Auto send calendars HTML via email
Contributing
- Fork it ( https://github.com/akwiatkowski/ocranizer/fork )
- Create your feature branch (git checkout -b my-new-feature)
- Commit your changes (git commit -am 'Add some feature')
- Push to the branch (git push origin my-new-feature)
- Create a new Pull Request
Contributors
- akwiatkowski Aleksander Kwiatkowski - creator, maintainer
ocranizer
- 7
- 2
- 1
- 0
- 0
- over 7 years ago
- January 17, 2017
MIT License
Thu, 07 Nov 2024 06:01:11 GMT