Skip to content

Commit

Permalink
Convert README to Markdown
Browse files Browse the repository at this point in the history
This lets us use exactly the same content for the README and the
GitHub Pages based website.
  • Loading branch information
justinclift committed May 13, 2014
1 parent da9f248 commit cf5d7b1
Show file tree
Hide file tree
Showing 2 changed files with 119 additions and 101 deletions.
119 changes: 119 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,119 @@
![SQLiteBrowser Screenshot](https://github.com/sqlitebrowser/sqlitebrowser/raw/master/images/sqlitebrowser.png "SQLiteBrowser Screenshot")

## What it is

SQLite Database Browser is a high quality, visual, open source tool to create, design, and edit database files compatible with SQLite.

It is for users and developers wanting to create databases, search, and edit data. It uses a familiar spreadsheet-like interface, and you don't need to learn complicated SQL commands.

Controls and wizards are available for users to:

* Create and compact database files
* Create, define, modify and delete tables
* Create, define and delete indexes
* Browse, edit, add and delete records
* Search records
* Import and export records as text
* Import and export tables from/to CSV files
* Import and export databases from/to SQL dump files
* Issue SQL queries and inspect the results
* Examine a log of all SQL commands issued by the application

## What it is not

This program is not a visual shell for the sqlite command line tool. It does not require familiarity with SQL commands. It is a tool to be used both by developers and by end users, and it must remain as simple to use as possible in order to achieve its goals.

## License

SQLite Database Browser is bi-licensed under the Mozilla Public License
Version 2, as well as the GNU General Public License Version 3 or later.

You can modify or redistribute it under the conditions of these
licenses.

## What's been done since the SourceForge project

* Qt3Support was removed
* Recent files menu added
* Improved UI, making it more modern, replacing some dialogs etc.
* Syntax highlighting for SQL code
* Cleaned up the code, reducing the SLOC quite a bit
* Added basic support for triggers and views
* Added pragma editing
* Added BLOB support
* Added a new filter row for searching
* Improved performance when opening large tables
* Extended the SQL tab
* Added SQLite extension support
* Fixed a ton of bugs
* Probably more

All in all a fair amount of the code has been rewritten in order to regain
maintainability. Based on this quite a few bugs can be fixed and new
features added.

## What's still to do

* Even more code cleanup
* Further improvement of the UI, adding more features and making it easier to use
* Feel free to add more issues at
https://github.com/sqlitebrowser/sqlitebrowser/issues

## Windows binaries

Windows binaries can be downloaded from here:

* https://github.com/sqlitebrowser/sqlitebrowser/releases

Nightly builds are also available at:

* http://rp.oldsch00l.com/sqlitebrowser/

## MacOS X

SQLite Database Browser works well on MacOS X.

* OSX 10.7 (Lion) and 10.8 (Mountain Lion) are tested and known to work

Building on OSX is simple, but depends on SQLite and Qt 4.8.x being installed
using Homebrew first::

$ brew install sqlite --with-functions
$ brew install qt --with-qt3support

Then it's just a matter of::

$ git clone https://github.com/sqlitebrowser/sqlitebrowser.git
$ cd sqlitebrowser
$ qmake
$ make
$ mv src/sqlitebrowser.app /Applications/

An icon for "sqlitebrowser" should now be in your main OSX Applications
list, ready to launch.

## Old project pages

* http://sqlitebrowser.sourceforge.net
* https://sourceforge.net/projects/sqlitebrowser

## Releases

* [Version 3.0.3 released](https://github.com/sqlitebrowser/sqlitebrowser/releases/tag/sqlb-3.0.3) - 2014-04-28
* [Version 3.0.2 released](https://github.com/sqlitebrowser/sqlitebrowser/releases/tag/sqlb-3.0.2) - 2014-02-12
* [Version 3.0.1 released](https://github.com/sqlitebrowser/sqlitebrowser/releases/tag/sqlb-3.0.1) - 2013-12-02
* [Version 3.0 released](https://github.com/sqlitebrowser/sqlitebrowser/releases/tag/sqlb-3.0) - 2013-09-15
* [Version 3.0rc1 released](https://github.com/sqlitebrowser/sqlitebrowser/releases/tag/rc1) - 2013-09-09 - Project now on GitHub
* Version 2.0b1 released - 2009-12-10 - Based on Qt4.6
* Version 1.2 released - 2005-04-05
* Version 1.1 released - 2004-07-20
* Version 1.01 released - 2003-10-02
* Version 1.0 released to public domain - 2003-08-19

## History

This program was developed originally by Mauricio Piacentini (@piacentini) from Tabuleiro Producoes, as the Arca Database Browser. The original version was used as a free companion tool to the Arca Database Xtra, a commercial product that embeds SQLite databases with some additional extensions to handle compressed and binary data.

The original code was trimmed and adjusted to be compatible with standard SQLite 2.x databases. The resulting program was renamed SQLite Database Browser, and released into the Public Domain by Mauricio. Icons were contributed by Raquel Ravanini, also from Tabuleiro. Jens Miltner contributed the code to support SQLite 3.x databases for the 1.2 release.

Pete Morgan (@daffodil) created an initial project on GitHub with the code in 2012, where several contributors fixed and improved pieces over the years. René Peinthor (@rp-) and Martin Kleusberg (@MKleusberg) then became involved, and have been the main driving force from that point. Justin Clift (@justinclift) helps out with testing on OSX, and started the new github.com/sqlitebrowser organisation on GitHub.
101 changes: 0 additions & 101 deletions README.rst

This file was deleted.

0 comments on commit cf5d7b1

Please sign in to comment.