cherrytree

cherrytree

A hierarchical note taking application, featuring rich text and syntax highlighting, storing data in a single xml or sqlite file.

Written by Giuseppe Penone (aka giuspen).

A complete user manual is handled by Robert Boudreau:
online html / ctb to download

The following languages are supported:

  • Armenian (Seda Stamboltsyan, up to date)
  • Chinese Simplified (Channing Wong, up to date)
  • Czech (Pavel Fric, up to date)
  • Dutch (TO BE UPDATED)
  • English (default)
  • French (TO BE UPDATED)
  • German (Frank Brungräber, up to date)
  • Italian (Vincenzo Reale, up to date)
  • Polish (Marcin Swierczynski, up to date)
  • Portuguese Brazil (TO BE UPDATED)
  • Russian (Andriy Kovtun, up to date)
  • Spanish (Daniel MC, up to date)
  • Ukrainian (Andriy Kovtun, up to date)

 

features features
download download
dev. versions development
bug tracker plugins

cherrytree

cherrytree

cherrytree

cherrytree

cherrytree

cherrytree



top
help features :

  • rich text (foreground color, background color, bold, italic, underline, strikethrough, small, h1, h2, h3, subscript, superscript, monospace)
  • syntax highlighting supporting several programming languages
  • images handling: insertion in the text, edit (resize/rotate), save as png file
  • embedded files handling: insertion in the text, save to disk
  • lists handling (bulleted, numbered, to-do and switch between them, multiline with shift+enter)
  • simple tables handling (cells with plain text), cut/copy/paste row, import/export as csv file
  • codeboxes handling: boxes of plain text (optionally with syntax highlighting) into rich text, import/export as text file
  • alignment of text, images, tables and codeboxes (left/center/right)
  • hyperlinks associated to text and images (links to webpages, links to nodes/nodes + anchors, links to files, links to folders)
  • spell check (using pygtkspellcheck and pyenchant)
  • intra application copy/paste: supported single images, single codeboxes, single tables and a compound selection of rich text, images, codeboxes and tables
  • cross application copy/paste (tested with libreoffice and gmail): supported single images, single codeboxes, single tables and a compound selection of rich text, images, codeboxes and tables
  • copying a list of files from the file manager and pasting in cherrytree will create a list of links to files, images are recognized and inserted in the text
  • print & save as pdf file of a selection / node / node and subnodes / the whole tree
  • export to html of a selection / node / node and subnodes / the whole tree
  • export to plain text of a selection / node / node and subnodes / the whole tree
  • toc generation for a node / node and subnodes / the whole tree, based on headers h1, h2 and h3
  • find a node, find in selected node, find in selected node and subnodes, find in all nodes
  • replace in nodes names, replace in selected node, replace in selected node and subnodes, replace in all nodes
  • iteration of the latest find, iteration of the latest replace, iteration of the latest applied text formatting
  • import from html file, import from folder of html files
  • import from plain text file, import from folder of plain text files
  • import from basket, cherrytree, epim html, gnote, keepnote, keynote, knowit, mempad, notecase, tomboy, treepad lite, tuxcards, zim
  • export to cherrytree file of a selection / node / node and subnodes / the whole tree
  • password protection (using http://www.7-zip.org/) – NOTE: while a cherrytree password protected document is opened, an unprotected copy is extracted to a temporary folder of the filesystem; this copy is removed when you close cherrytree
  • tree nodes drag and drop


TODO :

  • assign custom icons to nodes/sub nodes and add option to sub-folder/notes (child) to take on parent icon
  • open several cherrytree files (notebooks) at the same time with tabs (all in the same window-single instance)
  • customize own keyboard shortcuts
  • cut copy and paste nodes
  • option to edit pictures with external editor
  • user defined text style (font, bold, color,…)
  • option to set the max line length/max page width
  • spreadsheet node
  • opportunity for a node to have columns
  • allow drag n drop of images and files to cherrytree
  • add the word counter for a node/the whole tree
  • allow to open a formatting tag for future text
  • better table export to html (respect column width, text align, single line border)
  • do not truncate codebox width in export to html
  • export to html: option to have different color background for the tree
  • export to html: option to have the nodes to collapse/expand
  • numbered lists: double space after one digit numbers to be aligned with 2 digits numbers
  • export node and subnodes as an only html structured document (initial menu  with hyperlinks to diferents subnodes)
  • option to make text double-spaced
  • save datetime creation and last datetime modification for every node. Also ability for search in nodes filtered by datetime creation/modification and view a list of nodes created/modificated in an interval
  • export a node with its subnodes to .odt
  • utility (dialog) where it’s possible to see all the tags (tree of the only tags) plus statistics about the tags
  • in code nodes allow compile/execute/code completion
  • possibility to set up custom properties for h1,h2,h3 (color, style…)
  • more options for the tables (automatic expand the table to the width of the screen)
  • sub item pressing the TAB key in bullet or numerical list
  • import from pdf
  • export to LaTeX
  • smart quotes
  • node property (written in database) to open a node expanded by default
  • utility to insert formulas (using LaTex that converts to png or something else))
  • option to have the font in nodes names decrease automatically proportionally to the node depth
  • selecting a set of text (e.g. space separated) and create a table with it or paste text into a table
  • customizable menus font size
  • add crop capability to image resize dialog
  • multiple selection of nodes for move and delete
  • opportunity to have multiple nodes point to the same data (many node-views pointing to the same node-data)
  • option to sort text rows by selection
  • numbered+checked list together
  • cherrytree for android
  • improve the numbers handling in nodes sorting
  • option to display hierarchy in node name header
  • option to enable tooltips over nodes names in the tree
  • option to have 2 views of the same node content (maybe multiple codeboxes with a single content)
  • automatic link to node if writing node name (with no spaces and camelcase)
  • allow to select text and edit equivalent html in a dialog, then insert html from dialog to text
  • symlinks not selectable in file open dialog on windows os
  • proxy support (for copy/paste from web browser)
  • export to epub
  • option to use double click to visit links
  • ctrl+shift+v should disable automatic link recognition
  • strip leading and trailing empty spaces when applying a list type to selected text, option to ensure trailing char (e.g. “;”)
  • option to skip codeboxes and tables when pasting when pasting from web page
  • option to call a script at autosave time
  • bug: replace text in node but not tables/codeboxes
  • option to recall latest find and replace patterns
  • export to markdown
  • option to insert tags also in text maybe with shortcuts
  • import from iPython notebook
  • more headings (h4 and h5)
  • multiple rows selection for cut/copy/paste/delete in tables
  • option in export to txt of multiple nodes to save hierarchically creating subfolders
  • dedicated and configurable font for plain text
  • preserve text alignment in print/export to pdf
  • option to link to a node + a line number
  • export/import text with indentation, each tab marking a level
  • pick existing formatting from the text below the cursor and use the formatting elsewhere
  • add option to send VACUUM to the sqlite database
  • command line argument to run export
  • allow coloured text in table cells
  • configurable auto-close of document after set time of inactivity
  • possibility to execute using python mathematical expression in node (writing expression and result)
  • add one or more custom commands to be executed on the selected text
  • support for Right-to-Left languages (lost in export to HTML and PDF)
  • add possibility to automatically have navigation links at the bottom of nodes like in the manual
  • handle link to email address and link to thunderbird mails like thunderlink://messageid=…
  • links to files: option to open the folder that contains the file (“open file location”)
  • dialog with find matches not modal but maybe below



top

downloaddownload last version 0.35.4 (Nov 10th, 2014 – changelog) :

tar.gz archive source code (GPLv3+): cherrytree-0.35.4.tar.xz
(depends: python2, python-gtk2, python-gtksourceview2, p7zip-full, python-enchant, python-dbus)
deb package debian/ubuntu package : cherrytree_0.35.4-1_all.deb
(Vincent Cheng’s PPA: https://launchpad.net/~vincent-c/+archive/cherrytree)
7z archive microsoft windows installer : cherrytree_0.35.4_setup.exe
NOTE: if you use cherrytree before installing a new version, you may find an error trying to overwrite “dbus-daemon.exe” which is in use, in this case just skip the overwrite or reboot and then the installation should run smoothly.
7z archive microsoft windows portable archive : cherrytree_0.35.4_win32_portable.7zNOTE: if you want to use a preferences file local to the portable folder, just create an empty file named “config.cfg” in the “bin” folder (where cherrytree.exe is).


downloaddownload old version :

cherrytree-0.34.1.tar.xz
cherrytree_0.34.1-1_all.deb
cherrytree_0.34.1_setup.exe
cherrytree_0.34.1_win32_portable.7z

cherrytree-0.33.4.tar.xz
cherrytree_0.33.4-1_all.deb
cherrytree_0.33.4_setup.exe
cherrytree_0.33.4_win32_portable.7z

cherrytree-0.32.0.tar.xz
cherrytree_0.32.0-1_all.deb
cherrytree_0.32.0_setup.exe
cherrytree_0.32.0_win32_portable.7z

cherrytree-0.31.5.tar.xz
cherrytree_0.31.5-1_all.deb
cherrytree_0.31.5_setup.exe
cherrytree_0.31.5_win32_portable.7z

cherrytree-0.30.5.tar.xz
cherrytree_0.30.5-1_all.deb
cherrytree_0.30.5_setup.exe
cherrytree_0.30.5_win32_portable.7z

gnome resides in applications–accessories–cherrytree



top
plugins development versions :

the source code is version controlled with mercurial and hosted by google code.
you can get a clone of the cherrytree mercurial repository issuing the command:

terminal hg clone https://code.google.com/p/giuspen-cherrytree/ hg_cherrytree
terminal cd hg_cherrytree
terminal ./cherrytree

that will create a folder named hg_cherrytree in the terminal working directory, enter into it and run cherrytree development version.

in order to update the local repository with the server repository updates you don’t need to “hg clone” all the time but simply run the following command from a terminal whose working directory is hg_cherrytree:

terminal hg pull -u

NOTE: for running from Python source in windows you need the following:
• download http://www.giuspen.com/software/gtk-2.24.10-win-bundle.7z and extract to C:\
• install Python 2.7.x 32bit from https://www.python.org/
• add “C:\gtk2\bin” and “C:\Python27” to the environment variable “Path”
• install PyGTK all in one installer from http://www.pygtk.org/downloads.html being sure to include at installation time PyGtkSourceView2
• download http://www.giuspen.com/software/C_Python27_Lib.7z and extract the content of the folder C_Python27_Lib to C:\Python27\Lib
• in order to have spell check working you need to install also http://pythonhosted.org/pyenchant/
• in order to use password protection you need to put 7za.exe in the folder hg_cherrytree or in a folder which is in the environment variable “Path” (download from http://downloads.sourceforge.net/sevenzip/7za920.zip)
• in folder hg_cherrytree, instead of command “./cherrytree” use “python cherrytree”

 

top