#+TITLE:  Orgmode Agenda utility
#+OPTIONS: toc:nil author:nil

[[https://gitlab.com/Titan-C/org-mode-agenda/-/commits/master][https://gitlab.com/Titan-C/org-mode-agenda/badges/master/pipeline.svg]]
[[https://www.gnu.org/licenses/gpl-3.0][https://img.shields.io/badge/License-GPL%20v3-blue.svg]]


This python script downloads your caldav calendars and generates and org
agenda file.

* Install
#+BEGIN_SRC bash
pip install org-mode-agenda
#+END_SRC
** Development
To use the developer version

#+BEGIN_SRC bash
git clone https://gitlab.com/Titan-C/org-mode-agenda.git
cd org-mode-agenda
python setup.py develop
#+END_SRC
* Configuration
Edit the config file =~/.calendars.conf=. The =DEFAULT= section configures
where to write the output and days ahead and back from execution date.

Then every new section is a calendar file. You can name sections as you
prefer. This names have no influence on the output file.
#+BEGIN_SRC bash
[DEFAULT]
outfile=~/org/caldav.org
ahead=90 # Days ahead from today
back=28 # Days in the past

[work] # Calendar name
user = on
passwordstore=Correos/mx.tribe29.com
# url for direct download of ics file
url=https://website.com/dav/calendar/personal?export
#+END_SRC
* Use
This package installs and executable script. Just call it directly
#+BEGIN_SRC bash
org_agenda_sync
#+END_SRC

It supports some commands line options
#+BEGIN_SRC bash :results output :exports both
org_agenda_sync -h
#+END_SRC

#+RESULTS:
: usage: org_agenda_sync [-h] [-f] [-v]
:
: Translate CalDav Agenda to orgfile
:
: optional arguments:
:   -h, --help     show this help message and exit
:   -f, --force    Force Download of Caldav files
:   -v, --verbose


* Contributions
You can kindly tip me for this project

- Stellar :: GDPTOFND6HSE5AVHPRXOCJFOA6NPFB65JAEWKTN23EBUGBB2AU4PLIBD
* License
#+begin_quote
    org-mode-agenda
    Copyright (C) 2020  Óscar Nájera

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.
#+end_quote
