Giter VIP home page Giter VIP logo

exchange2org's Introduction

exchange2org

This is how it looks on my agenda:

screenshot_emacs.png

The “⦿”-characters are links to the corresponding Outlook items. Read my configuration on how to open outlook links.

Those are the source appointments from my Outlook 2016 (dark theme):

screenshot_outlook.png

Here is how I get the appointments from Outlook to Org-mode:

./exchange2org/__init__.py --help
usage: /usr/bin/exchange2org [-h] [--calendar] [--startday date-or-days]
                             [--endday date-or-days]
                             [--ignore-category CATEGORY] [-s] [-v] [-q]
                             FILE

This tool connects to your Exchange server and extracts data
in Org-mode format.

Please do note that this is a TEMPORARY stand-alone tool which will
be added to Memacs as an module as soon as Memacs got migrated to
Python 3:   https://github.com/novoid/memacs/

You can configure the behavior and output via a configuration file.

Example usages:
  exchange2org --calendar some/subfolder/my_exchange_calendar.org
      … writes your calendar events into the Org-mode file.

positional arguments:
  FILE                  The filename of the output file

optional arguments:
  -h, --help            show this help message and exit
  --calendar            Extract the calendar as Org-mode events.
  --startday date-or-days
                        Starting date for fetching data. Default: 60 days in
                        past. "date-or-days" is either of form "YYYY-MM-DD" or
                        a number.
  --endday date-or-days
                        End date for fetching data. Default: 60 days in
                        future. "date-or-days" is either of form "YYYY-MM-DD"
                        or a number.
  --ignore-category CATEGORY
                        Category whose events will be omitted.
  -s, --dryrun          enable dryrun mode: simulate what would happen, do not
                        modify anything
  -v, --verbose         enable verbose mode
  -q, --quiet           enable quiet mode

:copyright: (c) by Karl Voit <[email protected]>
:license: GPL v3 or any later version
:URL: https://github.com/novoid/exchange2org
:bugreports: via github or <[email protected]>
:version: 2018-02-03
·

Installation

Clone it via GitHub or install pip exchange2org

You’re going to need a configuration file. On GNU/Linux, this is: $HOME/.config/exchange2org/exchange2orgconfig.py

This repository (as well as the pip package) comes with a template file named exchange2orgconfig-TEMPLATE.py you can modify to meet your requirements.

Automatization

I personally run following command via cron Monday to Friday during office hours:

$HOME/src/exchange2org/exchange2org/__init__.py --calendar --startday 7 \
    --endday 45 $HOME/org/exported-company-calendar.org -q --ignore-category 'Org-mode'

On Sunday, I archive my calendar with the following script:

#!/bin/sh

TMPFILE=`mktemp`
ARCHIVEFILE='$HOME/org/memacs/company-calendar-archive.org_archive'

# It gets the previous 7 days of events, greps out the header (take
# only lines starting with two asterisks) and appends them to the
# archive file:

$HOME/src/exchange2org/exchange2org/__init__.py --calendar --quiet \
         --startday 7 --endday 0 --ignore-category 'Org-mode' "${TMPFILE}" && \
    egrep '\*\* <' "${TMPFILE}" >> "${ARCHIVEFILE}" && \
    rm "${TMPFILE}"
#end

When I categorize an Outlook-appointment with “Org-mode”, the commands above ignore the appointment. This is quite handy when you have created (or copied) a manual event for that very same appointment and you don’t want to have it twice in your agenda. Please note that you can right-click any appointment in your calendar to assign categories without sending updates or similar annoyances.

How to Thank Me

I’m glad you like my tools. If you want to support me:

  • Send old-fashioned postcard per snailmail - I love personal feedback!
  • Send feature wishes or improvements as an issue on GitHub
  • Create issues on GitHub for bugs
  • Contribute merge requests for bug fixes
  • Check out my other cool projects on GitHub

Local Variables

exchange2org's People

Contributors

novoid avatar

Watchers

James Cloos avatar em429 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.