French

Makagiga - README

Table of Contents

What is Makagiga?

To-do manager, notepad, RSS reader...

Makagiga is an open-source, easy-to-use, portable application for doing a variety of tasks, such as todo listing, text editing, or RSS reading. Plugins are used to implement its various capabilities.

Requirements

Makagiga requires Java(tm) SE 8 (JRE).

The following platforms are currently officially supported: Linux, Windows (XP/Vista/7/8/10)

You can try to run Makagiga on the following platforms as well: Mac OS X, Solaris

Troubleshooting

Exception in thread "main" java.lang.UnsupportedClassVersionError: org/makagiga/Main : Unsupported major.minor version 52.0

Exception in thread "main" java.lang.UnsupportedClassVersionError: org/makagiga/Main : Unsupported major.minor version 51.0

Makagiga still not starting

Possible solutions:

Installation

Note: Exit Makagiga before you start the installation.

Java Installation

See Wiki page.

Upgrading

Reqular Version

Just run the installer and overwrite the old Makagiga program files.

Portable Version

Downgrading

Installing older Makagiga version is possible but not recommended. Some features introduced in newer versions are simply not available in older software.

RSS Archive

RSS Archive in Makagiga 4.x is incompatible with Makagiga 3.x. You can find the backup of the OLD archive in RSS Archive Backup (for Makagiga 3.x).zip file.

Debian/Ubuntu package - *.deb file

  1. Run sudo dpkg -i makagiga-YOUR_VERSION.deb to install (requires administrator password)
  2. Run sudo dpkg -r makagiga to uninstall
  3. How to install Makagiga in Ubuntu (video by Tejash Patel)

RPM package - *.rpm file

  1. Run su -c "rpm -Uvh makagiga-YOUR_VERSION.rpm" to install (requires administrator password)
  2. Run su -c "rpm -e makagiga" to uninstall

Portable package - *.zip file

  1. Unpack makagiga-YOUR_VERSION.zip file
  2. ...start: ./makagiga.sh (or "sh ./makagiga.sh" if your file system does not allow executable (+x) scripts)
  3. ...install (optional): ./install.sh
  4. The application will be installed in the /usr/local (default prefix) directory. To change the installation directory, use the following command: ./install.sh /my_prefix/my_apps.
  5. Run YOUR_PREFIX/makagiga/uninstall.sh, to uninstall

Setup file - *.exe file

Run makagiga-YOUR_VERSION.exe to install. Use Control Panel to uninstall.

How to run? (Linux)

  1. METHOD #1: Run the makagiga command
  2. METHOD #2: Select the Makagiga command from the KDE/GNOME menu (Office section)

Configuration

Portable Application

You can launch Makagiga directly from a writeable and removable storage device (USB flash drive or flash card). To do this simply unzip makagiga-VERSION.zip file, then launch makagiga-portable.exe / makagiga-portable.bat (Windows) or ./makagiga-portable.sh (Linux). All data files will be stored in the same directory where Makagiga was unzipped. If everything is OK, you should notice "[Portable]" text in the main window title.

Profiles

To start with custom profile, you need to use --profile command line option, or the MAKAGIGA_PROFILE environment variable. Note that the "Profile Name" is a directory name, so it cannot contain "/", "\", "." or any other illegal characters. All profiles are stored in the user's home directory (e.g. ~/.makagiga/profiles).

Example 1: makagiga --profile "Profile Name"

Example 2: export MAKAGIGA_PROFILE="Profile Name"; makagiga

To change directory with user files, you need to use --user-files command line option, or the MAKAGIGA_USER_FILES environment variable. The "User Files" directory must already exist.

Example 1: makagiga --user-files "/home/foo/Makagiga"

Example 2: export MAKAGIGA_USER_FILES="/home/foo/Makagiga"; makagiga

Note: You cannot use both --profile and --user-files options.

Environment Variables

JAVA_HOME

Change the default Java launcher.

Example: JAVA_HOME=/usr/java/jre1.8.0

MAKAGIGA_LANG

[Linux] Overrides the default locale settings (language translation, date format, etc.).

Example: MAKAGIGA_LANG=pl_PL

License & Copyright

Makagiga - (C) Konrad Twardowski
Image Filters - (C) Jerry Huxtable
Apache Commons Codec - (C) The Apache Software Foundation

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

  http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.


Trident - a powerful and extensible animation library for Java applications
Copyright (c) Kirill Grouchnikov
Licensed under BSD license.


Makagiga Logo by MaƂgorzata Kiszka


The Oxygen Icon Theme
Creative Common Attribution-ShareAlike 3.0 license
or the GNU Library General Public License (with following clarification):

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

    This library 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
    Library General Public License for more details.

    You should have received a copy of the GNU Library General Public
    License along with this library; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA  02110-1301 USA

Clarification:

  The GNU Lesser General Public License or LGPL is written for
  software libraries in the first place. We expressly want the LGPL to
  be valid for this artwork library too.

  KDE Oxygen theme icons is a special kind of software library, it is an
  artwork library, it's elements can be used in a Graphical User Interface, or
  GUI.

  Source code, for this library means:
   - where they exist, SVG;
   - otherwise, if applicable, the multi-layered formats xcf or psd, or
  otherwise png.

  The LGPL in some sections obliges you to make the files carry
  notices. With images this is in some cases impossible or hardly useful.

  With this library a notice is placed at a prominent place in the directory
  containing the elements. You may follow this practice.

  The exception in section 6 of the GNU Lesser General Public License covers
  the use of elements of this art library in a GUI.

  kde-artists [at] kde.org


"Emotion" Icon Set by Yellowicon Studio
www.everaldo.com
www.yellowicon.com


Old Icon Theme
by Everaldo Coelho
and the KDE Team


Duke: The Java Mascot
Berkeley Software Distribution (BSD) License


SourceForge.net Logo
(C) SourceForge, Inc.

(C) 2005-3000 Konrad Twardowski