Logo Search packages:      
Sourcecode: barry version File versions  Download package


<? createHeader("barry - BlackBerry &trade; synchronization for Linux"); ?>

<? include ("barry.inc"); ?>

<div class="subHeader">Overview</div>

<p>Linux users who also use a BlackBerry &trade; now have an option for
managing their BlackBerry directly from Linux.</p>

<p>Barry is an Open Source application that will provide synchronization,
backup, restore and program management for BlackBerry &trade; devices.
Barry is primarily developed on Linux, but is intended as a cross platform
library and application set, targeting Linux, BSD, 32/64bit, and big/little
endian systems.

<p>The Barry project began in October 2005 and has steadily added features
and polish to Blackberry usage on Linux ever since.  We were the first to
reverse engineer the battery charging handshake via USB.</p>

<p>Today, it is possible to:

      <li> charge your Blackberry's battery from your USB port </li>
      <li> retrieve Address Book, Email, Calendar, Service Book, Memos,
            Tasks, PIN Messages, Saved Email, and Folders </li>
      <li> export Address Book contacts in text or LDAP LDIF format </li>
      <li> make full data backups and restores of your device using
            a GUI</li>
      <li> synchronize contacts and calendar items using the
            <a href="http://www.opensync.org/">OpenSync</a>
      <li> use the Blackberry as a modem</li>

<div class="subHeader">Status</div>

      <li>Latest release: <b>0.14</b></li>
      <li>Download source and binary packages from
            <a href="http://sourceforge.net/project/showfiles.php?group_id=153722">Sourceforge</a> or the <a href="http://download.opensuse.org/repositories/home:/ndprojects/">OpenSUSE Build Service</a></li>
      <li>General <a href="http://sourceforge.net/projects/barry/">Sourceforge project page</a></li>
      <li><a href="http://repo.or.cz/w/barry.git">Barry git repo</a></li>
      <li>Known Issues:
            <li>Restoring backups for some databases on newer Blackberries doesn't work (for example, on the 8120, 8700g)</li>
            <li>Syncing is not supported on Fedora Core 9, since they packaged the OpenSync 0.3x devel tree</li>
            <li>Password support when using Blackberry as modem is experimental</li>
            <li>Accessing the database (such as during a backup) while copying files using the usb_storage kernel module may cause some Blackberries to spontaneously reboot</li>
            <li>The opensync plugin does not handle international characters well.</li>

<div class="subHeader">Getting Started</div>

<p>How do I...
      <li><? createLink("install", "Install Barry from binary packages"); ?></li>
      <li><? createLink("cvs", "Compile Barry from tarball, CVS, or git"); ?></li>
      <li><? createLink("backups", "Make backups of my Blackberry data"); ?></li>
      <li><? createLink("sync", "Sync my Blackberry with Evolution"); ?></li>
      <li><? createLink("modem", "Use my Blackberry as a modem to surf the net"); ?></li>
      <li><? createLink("troubleshooting", "Find troubleshooting help"); ?></li>
      <li><? createLink("bugs", "Report a bug"); ?></li>
      <li><? createLink("patches", "Submit a patch"); ?></li>
      <li><? createLink("contact", "Contact the developers"); ?></li>

<p>Some helpful lists:
      <li><? createLink("requirements", "System requirements"); ?></li>
      <li><? createLink("dependencies", "Software dependencies"); ?></li>

<div class="subHeader">How to Help</div>

<p>If you are a C++ programmer, grab the source from
<? createLink("cvs", "CVS"); ?> and take a look at the TODO file.
Post a message to the
<a href="http://sourceforge.net/mail/?group_id=153722">mailing list</a>
when you start working on any of the listed features, so you can connect
with other developers, and avoid duplicating effort.</p>

<p>If you are a Python programmer, contact the mailing list, since we
would like to create and test a Python interface to the Barry library.</p>

<p>If you are not a programmer, but have a Blackberry, we can always use
help in testing.  Install Barry on your system, and
<? createLink("bugs", "report any bugs"); ?> you find.</p>

<p>If you prefer writing documentation, grab the source from
<? createLink("cvs", "CVS"); ?> and look under the doc/www directory.
Documentation is currently in html form, as well as doxygen-generated
API documentation found in the comments of the source code itself.
Patches updating either set of documentation are welcome.</p>

<p>There are dozens of databases that need to be documented and supported
in the library.  If you have a BlackBerry &trade; device and are interested
in helping decipher data, we have a
<? createLink("hacking", "Barry hacking document"); ?> that will help you.

<div class="subHeader">Design</div>

<p>If you are interested in helping out or just interested in how it works,
check out our <? createLink("design", "design notes"); ?>.

<div class="subHeader">Roadmap</div>

<p>We have put together a document that describes where we are and where we
want to take Barry. Check out our <? createLink("roadmap", "roadmap"); ?>
to see what's happening.</p>

<div class="subHeader">External Links</div>

<p>Barry users and others have contributed documentation and have
put these howto's on the web.  Below is a list of some of these pages.
These sites are not associated with NetDirect, and some of the information
may be out of date, but they may still be helpful to new users.</P>

      <li><a href="http://www.chipbennett.net/wordpress/index.php/2008/05/synchronizing-a-blackberry-in-linux/">Synchronizing a Blackberry In Linux</a>, by Chip Bennett</li>
      <li><a href="http://www.linux.com/feature/123251">Syncing your Blackberry on Linux</a>, by Joe Barr</li>
      <li><a href="http://off.net/cassis/protocol-description.html">The RIM Blackberry Serial Protocol</a>, by Phil Schwan, Mike Shaver, and Ian Goldberg, of the Cassis project</li>
      <li><a href="http://www.blackberryforums.com/blackberry-guides/2019-user-howto-use-blackberry-modem-laptop.html">HOWTO: Blackberry as Modem for Laptop</a>, by Mark Rejhon, (not Linux specific)</li>

Generated by  Doxygen 1.6.0   Back to index