Introduction

CrunchyFrog is a database front-end for Gnome.

Download and Installation

Requirements

• Python >= 2.5
• PyGTK >= 2.12
• python-setuptools
• GNOME bindings, including extras (gtksourceview2, gnomekeyring)
• GConf bindings
• python-pysqlite2 >= 2.0.5
• python-configobj >= 4.4.0
• python-lxml >= 0.9
• gnome-extra-icons
• python-sexy

The following modules are required for specific database backends:

• psycopg2 (optional, required to connect to PostgreSQL databases)
• MySQLdb (optional, required to connect to MySQL databases)
• sqlite3 bindings (optional, required to connect to SQLite3 databases)
• cx_Oracle (optional, required to connect to Oracle databases)
• ldap bindings (optional, required to browse LDAP servers)
• pymssql bindings (optional, required to connect to SQL Server)

Getting Started

This section explains how start and how the main window looks like.

Note

If you have any troubles running CrunchyFrog, make sure that all requirements are met.

To Start CrunchyFrog

You can start CrunchyFrog in the following ways:

Applications menu

Choose Development ‣ CrunchyFrog.

Command line

To start CrunchyFrog from a command line, type the following command, then press Return: crunchyfrog [FILE1, FILE2, ...] where FILE1 and FILE2 are optional filenames of files you want to open.

CrunchyFrog opens each file that you specify in the same window. If another instance of CrunchyFrog is running, CrunchyFrog opens a dialog where you can choose, if you want to open the specified files in an existing or a new instance of CrunchyFrog.

Main Window

When you start CrunchyFrog, the following window is displayed.

The CrunchyFrog window has the following elements:

Menubar

The menus on the menubar contain all of the commands you need to work with files in CrunchyFrog. Plugins can add additionally menus to the menubar.

Toolbar

The toolbar contains a subset of the commands that you can access from the menubar.

Display area

The display area has different elements, depending on the activated plugins. By default, the display area contains the database navigator on the left and a placeholder for SQL editors on the right.

Statusbar

The statusbar displays information about current CrunchyFrog activity and contextual information about selected elements.