KonsoleKalendar: Difference between revisions

Latest revision as of 11:01, 25 February 2025

Use your calendar when you can't use a graphical user interface

konsolekalendar is an application to administer a calendar without a graphical user interface. It normally works with the calendar that is marked "Default", if you use KOrganizer. However, it is possible to create a calendar if you don't have one already.

As it is strictly a command-line application, konsolekalendar's syntax must be learned first.

Here is a short introduction to using konsolekalendar:

If you do not already have a calendar set up, you first need to create one:

konsolekalendar --create --file ~/.kde/share/apps/korganizer/vacation.ics

(This location will enable it to be used either in konsolekalendar or in korganizer.)

Add your birthday to the default calendar:

konsolekalendar --add --date 2009-06-06 --summary "My Birthday" --description "Party Time"

Add a vacation:

konsolekalendar --add --file vacation.ics --date 2009-08-01 --end-date 2009-08-07 --summary "Vacation" \
  --description "Nobody will ever find me!"

Show all calendar entries:
```
konsolekalendar --all 2>errorlog
```

You probably don't want to do this if you have been using your calendar for long, however, you can specify date ranges, as in…
```
konsolekalendar --view --date 2009-08-17 --end-date 2009-08-21
```

…which shows that particular work week.

Or maybe you only wanted to see the next entry? Then use:
```
konsolekalendar --next
```

Or for the week ahead? Try:
```
konsolekalendar --show-next 7
```

To show your calendar file, the rubric is:

konsolekalendar --view 2>&1 | grep resource | grep konsolekalendar

To edit an entry, use:

konsolekalendar --change --uid libkcal-1652809671.172 --summary "Get my head examined" \
  --description "I must be crazy!!"

Before you can delete an entry, you first need to list it:

There at the bottom is the UID of the entry.

Now you are ready to delete it:

konsolekalendar --delete --uid libkcal-1652809671.172

Warning

Beware - this is a permanent delete. You cannot recover the entry

Export a calendar; it is possible to export to several formats, including CSV and HTML:
```
konsolekalendar --export-type CVS current.ics
```

Import a calendar:

konsolekalendar --import another.ics --file current.ics

In this case, all the entries from another.ics will be merged into current.ics.

@@ Line 1: / Line 1: @@
-{{Template:I18n/Language Navigation Bar|KonsoleKalendar}}
+<languages />
+<translate>
-{|style="text-align:center" cellpadding="2"
+<!--T:1-->
-|[[Image:Konsolekalendar-view.png|250px|thumb]]||'''Use your calendar when you can't us a graphical user interface'''
+{|class="tablecenter vertical-centered"
+ | [[File:Konsolekalendar-view.png|250px|thumb]]
+ | '''Use your calendar when you can't use a graphical user interface'''
 |}
-konsolekalendar is an application to administer a calendar without a graphical user interface. It normally works with the calendar that is marked Default, if you use KOrganizer.  However, it is possible to create a calendar if you don't have one already.
+<!--T:2-->
+'''konsolekalendar''' is an application to administer a calendar without a graphical user interface. It normally works with the calendar that is marked "Default", if you use '''KOrganizer'''.  However, it is possible to create a calendar if you don't have one already.
-As it is strictly a command-line application, konsolekalendar's syntax must be learned first.
+<!--T:3-->
+As it is strictly a command-line application, '''konsolekalendar''''s syntax must be learned first.
-Here is a short introduction to using konsolekalendar.
+<!--T:4-->
+Here is a short introduction to using '''konsolekalendar''':
-* If you do not already have a calendar set up, you first need to create one
- konsolekalendar --create --file ~/.kde/share/apps/korganizer/vacation.ics
-(This location will enable it to be used either in konsolekalendar or in korganizer.)
+<!--T:5-->
+* If you do not already have a calendar set up, you first need to create one: {{Input|lang=shell|1=konsolekalendar --create --file ~/.kde/share/apps/korganizer/vacation.ics}}
-* Add a calendar entry
+<!--T:6-->
- konsolekalendar --add --date 2009-06-06 --summary "My Birthday" \
+:(This location will enable it to be used either in '''konsolekalendar''' or in '''korganizer'''.)
---description "Party Time"
-adds your birthday to your default calendar.
-* Add a vacation
- konsolekalendar --add --file vacation.ics --date 2009-08-01 \
+<!--T:7-->
---end-date 2009-08-07 --summary "Vacation" --description "Nobody will ever find me!"
+* Add your birthday to the default calendar: {{Input|lang=shell|1=konsolekalendar --add --date 2009-06-06 --summary "My Birthday" --description "Party Time"}}
+<!--T:8-->
+* Add a vacation: {{Input|lang=shell|1=konsolekalendar --add --file vacation.ics --date 2009-08-01 --end-date 2009-08-07 --summary "Vacation" \
+  --description "Nobody will ever find me!"}}
-* Show all calendar entries
+<!--T:9-->
- konsolekalendar --all 2>errorlog
+* Show all calendar entries: {{Input|lang=shell|1=konsolekalendar --all 2>errorlog}}
-You probably don't want to do this, if you have been using your calendar for long.  However, you can specify date ranges:
-  konsolekalendar --view --date 2009-08-17  --end-date 2009-08-21
-shows that particular work-week.
+<!--T:10-->
+* You probably don't want to do this if you have been using your calendar for long, however, you can specify date ranges, as in… {{Input|lang=shell|1=konsolekalendar --view --date 2009-08-17 --end-date 2009-08-21}}
+:…which shows that particular work week.
+<!--T:11-->
+* Or maybe you only wanted to see the next entry? Then use: {{Input|lang=shell|1=konsolekalendar --next}}
+<!--T:12-->
+* Or for the week ahead? Try: {{Input|lang=shell|1=konsolekalendar --show-next 7}}
+<!--T:13-->
+* To show your calendar file, the rubric is: {{Input|lang=shell|1=konsolekalendar --view 2>&1 {{!}} grep resource {{!}} grep konsolekalendar}}
-* Maybe you only wanted to see the next entry?
- konsolekalendar --next
+<!--T:14-->
+* To edit an entry, use: {{Input|lang=shell|1=konsolekalendar --change --uid libkcal-1652809671.172 --summary "Get my head examined" \
+  --description "I must be crazy!!"}}
-* Or for the week ahead?
- konsolekalendar --show-next 7
+<!--T:15-->
+* Before you can delete an entry, you first need to list it: [[File:Konsolekalendar-list.png|thumb|right|641px]]
-* Show your calendar file
- konsolekalendar --view 2>&1 | grep resource | grep konsolekalendar
-* Edit an entry
+<!--T:16-->
- konsolekalendar --change --uid libkcal-1652809671.172 --summary "Get my head examined" --description "I must be crazy!!"
+:There at the bottom is the UID of the entry.
-* Before you can delete an entry, you first need to list it:
+<!--T:17-->
-{|cellpadding="2" align="center"
+{{Clear|right}}
-|[[Image:Konsolekalendar-list.png|300px]]
+:Now you are ready to delete it: {{Input|lang=shell|1=konsolekalendar --delete --uid libkcal-1652809671.172}}
-|}
-There at the bottom is the UID of the entry.
+<!--T:18-->
+{{Warning|Beware - this is a permanent delete.  You cannot recover the entry }}
-Now you are ready to delete it -
- konsolekalendar --delete --uid libkcal-1652809671.172
-::{|cellpadding="5"
+<!--T:19-->
-|[[Image:dialog-warning.png|32px]]||'''Warning'''||Beware - this is a permanent delete.  You cannot recover the entry
+* Export a calendar; it is possible to export to several formats, including ''CSV'' and ''HTML'': {{Input|lang=shell|1=konsolekalendar --export-type CVS current.ics}}
-|}
-* Export a calendar
-It is possible to export to several formats, including CSV and html.
- konsolekalendar --export-type CVS current.ics
+<!--T:20-->
+* Import a calendar: {{Input|lang=shell|1=konsolekalendar --import another.ics --file current.ics}}
-* Import a calendar
+<!--T:21-->
- konsolekalendar --import another.ics --file current.ics
+:In this case, all the entries from another.ics will be merged into current.ics.
-In this case, all the entries from another.ics will be merged into current.ics.
+<!--T:22-->
+[[Category:Office]]
+</translate>