Cournal is a collaborative note taking and journal application using a stylus.
Python Shell
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
cournal
i18n
icons/hicolor
release-preperation
.gitattributes
.gitignore
ChangeLog
LICENSE
LINKS.md
MANIFEST.in
README.md
THANKS
TODO
cournal-server.py
cournal.desktop.in
cournal.py
download-twisted.sh
generate_pot_file.sh
setup.py

README.md

Cournal is a collaborative note taking and journal application using a stylus.

Huh?

Cournal allows multiple users to annotate PDF files in real-time.

The goal of this project is a full featured note taking application (like Xournal or Windows Journal), which allows multiple people to collaborate (like Gobby).

Why not extend Xournal?

There have been numerous discussions over many years on the Xournal mailing list and Xournal++ even had experimental networking support, but it didn't work out. So I started Cournal, which got networking support just after PDF viewing and simple drawing was done. Therefore it was designed with networking in mind from scratch.

Does it work yet?

Yes, but you might miss some features (to change that, see next section ;-)).

How to help

You are very welcome to support the project!

To get into Cournal hacking, have a look at LINKS.md, which contains a list of most things you need to know. Feel free to contact me, if questions arise or if you want to improve Cournal, but don't know how to get started.

Dependencies

  • Python 3.x
  • Poppler 0.18 or newer
  • Cairo
  • GObject Introspection
  • GTK+ 3.2 or newer (GTK 3.4 is strongly recommended)
  • Python bindings for all above this line
  • ZopeInterface 3.6.0 or newer
  • Twisted for python3 (a download script is included)
  • Build-time: Gettext, Intltool

Installation

There are packages for Gentoo and Arch Linux. Users of other distributions will have to adapt the following Ubuntu guide:

  1. Download the latest Cournal release
  2. tar xvf cournal-?.?.?.tar.gz
  3. cd cournal-?.?.?
  4. ./download-twisted.sh
  5. sudo apt-get install python3 python3-zope.interface python3-gi python3-cairo gir1.2-poppler python3-gi-cairo gobject-introspection gir1.2-gtk-3.0
  6. sudo python3 setup.py install
  7. cournal

Usage

Server
./cournal-server.py -p [portnumber]
Client

Start Cournal, select "Annotate PDF" and then "Connect to Server".

Bugs

Please report bugs on https://github.com/flyser/cournal/issues.

File Format

The file format is compatible to Xournals .xoj files, but Cournal is not able to open some .xoj files created by Xournal, because it doesn't support all features of the file format. The other way around should work though.