Bazaar Explorer logo Bazaar Explorer - Version Control for Human Beings

Bazaar desktop applications

What is Bazaar?

Bazaar is a tool for helping people collaborate. It tracks the changes that you and other people make to a group of files - such as software source code - to give you snapshots of each stage of their evolution. Using that information, Bazaar can effortlessly merge your work with other people’s.

Tools like Bazaar are called version control systems (VCS) and have long been popular with software developers. Bazaar’s ease of use, flexibility and simple setup make it ideal not only for software developers but also for other groups who work together on files and documents, such as technical writers, web designers and translators.

What desktop tools are available?

This guide provides an easy to read introduction to using Bazaar via its GUI tools, including those below.

Category Tools
Standalone applications Bazaar Explorer
File manager add-ons TortoiseBZR, Natilus-bzr
IDE add-ons QBzr-Eclipse
Dialog suites QBzr, bzr-gtk

Bazaar Explorer is used in most of the examples, though other tools like TortoiseBZR and QBzr-Eclipse can be used exactly the same way in the majority of processes presented. Note that all three of these applications shared a common set of dialogs - QBzr - making it easy to switch between them.


The dialog suite used inside Bazaar Explorer is configurable. If you wish to use the bzr-gtk dialogs instead of the QBzr ones, simply install bzr-gtk and change the relevant preference.

How this guide is organized

This chapter covers some important initial ground: setting up your environment, core concepts to understand and troubleshooting.

Chapters 2-6 provide a closer look at how to use Bazaar to complete various tasks. It is recommended that most users read these in first-to-last order.

Chapter 7 explain how to integration Bazaar with other systems and use Bazaar as a front-end client on projects using Subversion, Git and Mercurial. This material can be read when required and in any order.

Remaining chapters provide tool-specific information. Chapter 8 explains how you can personalize Bazaar Explorer, making it the BYO editor IDE you’ll never want to leave! Help on using each QBzr and GTK dialog is provided next, followed by usage tips on the various file manager and IDE add-ons.


We hope you find this manual useful. If you have suggestions on how it or the rest of Bazaar’s documentation can be improved, please contact us on the mailing list,