doc/www/index.html

   1 <html>
   2
   3 <head>
   4         <title>Barry Documentation</title>
   5         <link rel="stylesheet" type="text/css" href="default.css">
   6
   7 </head>
   8
   9 <body>
  10
  11
  12 <div class='pageHeader'>barry - BlackBerry &trade; synchronization for Linux</div><img src='nothing.jpg' width='100%' height='5' alt=''><br><div class='linearNav'>
  13 <div class="subHeader">Overview</div>
  14 <p>Linux users who also use a BlackBerry &trade; now have an option for
  15 managing their BlackBerry directly from Linux.</p>
  16
  17 <p>Barry is an Open Source application that will provide synchronization,
  18 backup, restore and program management for BlackBerry &trade; devices.
  19 Barry is primarily developed on Linux, but is intended as a cross platform
  20 library and application set, targeting Linux, BSD, 32/64bit, and big/little
  21 endian systems.
  22 </p>
  23
  24 <p>The Barry project began in October 2005 and has steadily added features
  25 and polish to Blackberry usage on Linux ever since.  We were the first to
  26 reverse engineer the battery charging handshake via USB.</p>
  27
  28 <p>Today, it is possible to:
  29
  30 <ul>
  31         <li> charge your Blackberry's battery from your USB port </li>
  32         <li> parse the following database records:
  33                 Address Book,
  34                 Browser Bookmarks,
  35                 Calendar,
  36                 Content Store,
  37                 Folders,
  38                 Memos,
  39                 Messages (Email),
  40                 Phone Call Logs,
  41                 PIN Messages,
  42                 Saved Email,
  43                 Service Book,
  44                 SMS messages,
  45                 Tasks,
  46                 Time Zones
  47                 </li>
  48         <li> create the following database records:
  49                 Address Book,
  50                 Calendar,
  51                 Content Store,
  52                 Memos,
  53                 Tasks
  54                 </li>
  55         <li> export Address Book contacts in text, LDAP LDIF format, or
  56                 as MIME vCards </li>
  57         <li> import data in MIME vCard, vEvent, vJournal, and vTodo formats</li>
  58         <li> make full data backups and restores of your device using
  59                 a GUI</li>
  60         <li> synchronize contact, calendar, memo, and task items using the
  61                 <a href="http://www.opensync.org/">OpenSync</a>
  62                 framework (memos and tasks require the development OpenSync
  63                 libraries)</li>
  64         <li> use the Blackberry as a modem</li>
  65         <li> install and manage Java applications from the command line </li>
  66         <li> take screenshots of your device </li>
  67         <li> set the device time from the command line </li>
  68         <li> use raw channel support to communicate with BlackBerry
  69                 applications </li>
  70         <li> ... and more </li>
  71 </ul>
  72 </p>
  73
  74 <div class="subHeader">Status</div>
  75
  76 <p>
  77 <ul>
  78         <li>Latest release: <b>0.17</b>, released on 2011/02/10</li>
  79         <li>License: GPL v2 or later</li>
  80         <li>Download official source and binary packages from
  81                 <a href="http://sourceforge.net/project/showfiles.php?group_id=153722">Sourceforge</a></li>
  82         <li>General <a href="http://sourceforge.net/projects/barry/">Sourceforge project page</a></li>
  83         <li><a href="http://repo.or.cz/w/barry.git">Barry git repo</a></li>
  84         <li>Additional binary packages for the following distributions are available from various volunteers.  Note that these packages may already be available in your distro of choice, using the normal package managers.
  85                 <ul>
  86                         <li><a href="http://packages.debian.org/unstable/main/barry-util">Debian, in the unstable tree, packaged by Jose Carlos Garcia Sogo</a></li>
  87                         <li><a href="http://download.fedora.redhat.com/pub/fedora/linux/releases/">Fedora</a> (packaged by Nathanael Noblet) and the related RPM <a href="http://pkgs.fedoraproject.org/gitweb/?p=barry.git">git repo</a></li>
  88                         <li>Mandriva's RPM <a href="http://svn.mandriva.com/cgi-bin/viewvc.cgi/packages/cooker/barry/current/">SVN</a></li>
  89                 </ul>
  90         </li>
  91         <li>Known Issues:
  92         <ul>
  93                 <li>International characters in calendar and contact records
  94                         cause some devices to switch to a different low-level
  95                         protocol, which Barry does not yet support.</li>
  96                 <li>Restoring backups for some databases on newer Blackberries doesn't work (for example, on the 8120, 8700g)</li>
  97                 <li>Syncing is not supported on Fedora Core 9 or 10, since they packaged the OpenSync 0.3x devel tree (experimental support for the latest opensync SVN tree is included with a new plugin).  This has been fixed in Fedora 11, as they returned to version 0.22.</li>
  98         </ul>
  99         </li>
 100 </ul>
 101 </p>
 102
 103 <div class="subHeader">Getting Started</div>
 104 <p>How do I...
 105 <ul>
 106         <li><a href="install.html">Install Barry from binary packages</a>
 107 </li>
 108         <li><a href="cvs.html">Compile Barry from tarball, CVS, or git</a>
 109 </li>
 110         <li><a href="backups.html">Make backups of my Blackberry data</a>
 111 </li>
 112         <li><a href="sync.html">Sync my Blackberry with Evolution</a>
 113 </li>
 114         <li><a href="modem.html">Use my Blackberry as a modem to surf the net</a>
 115 </li>
 116         <li><a href="rawchannel.html">Use Blackberry USB channels with Barry</a>
 117 </li>
 118         <li><a href="troubleshooting.html">Find troubleshooting help</a>
 119 </li>
 120         <li><a href="bugs.html">Report a bug</a>
 121 </li>
 122         <li><a href="patches.html">Submit a patch</a>
 123 </li>
 124         <li><a href="contact.html">Contact the developers</a>
 125 </li>
 126 </ul>
 127 </p>
 128
 129 <p>Some helpful pages:
 130 <ul>
 131         <li><a href="requirements.html">System requirements</a>
 132 </li>
 133         <li><a href="dependencies.html">Software dependencies</a>
 134 </li>
 135         <li><a href="doxygen/html/index.html">Barry's Doxygen documentation</a>
 136 </li>
 137         <li><a href="devices.html">Device compatibility list</a>
 138 </li>
 139 </ul>
 140 </p>
 141
 142
 143 <div class="subHeader">How to Help</div>
 144 <p>If you are a C++ programmer, grab the source from
 145 <a href="cvs.html">CVS</a>
 146  and take a look at the TODO file.
 147 Post a message to the
 148 <a href="http://sourceforge.net/mail/?group_id=153722">mailing list</a>
 149 when you start working on any of the listed features, so you can connect
 150 with other developers, and avoid duplicating effort.</p>
 151
 152 <p>If you are a Python programmer, contact the mailing list, since we
 153 would like to create and test a Python interface to the Barry library.</p>
 154
 155 <p>If you are not a programmer, but have a Blackberry, we can always use
 156 help in testing.  Install Barry on your system, and
 157 <a href="bugs.html">report any bugs</a>
 158  you find.</p>
 159
 160 <p>If you prefer writing documentation, grab the source from
 161 <a href="cvs.html">CVS</a>
 162  and look under the doc/www directory.
 163 Documentation is currently in html form, as well as doxygen-generated
 164 API documentation found in the comments of the source code itself.
 165 Patches updating either set of documentation are welcome.</p>
 166
 167 <p>There are dozens of databases that need to be documented and supported
 168 in the library.  If you have a BlackBerry &trade; device and are interested
 169 in helping decipher data, we have a
 170 <a href="hacking.html">Barry hacking document</a>
 171  that will help you.
 172 </p>
 173
 174 <p>If you are interested in the low level USB protocol, you can download,
 175 or contribute, USB logs to the
 176 <a href="logs.html">USB capture log archive</a>
 177 .</p>
 178
 179
 180 <div class="subHeader">Design</div>
 181 <p>If you are interested in helping out or just interested in how it works,
 182 check out our <a href="design.html">design notes</a>
 183 .
 184
 185
 186 <div class="subHeader">Roadmap</div>
 187 <p>We have put together a document that describes where we are and where we
 188 want to take Barry. Check out our <a href="roadmap.html">roadmap</a>
 189 to see what's happening.</p>
 190
 191
 192 <div class="subHeader">External Links</div>
 193 <p>Barry users and others have contributed documentation and have
 194 put these howto's on the web.  Below is a list of some of these pages.
 195 These sites are not associated with NetDirect, and some of the information
 196 may be out of date, but they may still be helpful to new users.</P>
 197
 198 <p>
 199 <ul>
 200         <li><a href="http://www.progweb.com/modules/blackberry/index-en.html">How to use a Blackberry device with Linux</a>, by Nicolas Vivien (2009/03/06), and <a href="http://www.progweb.com/en/">his development blog</a></li>
 201         <li><a href="http://www.slashdev.ca/2008/04/03/blackberry-development-using-linux/">Blackberry development using Linux</a>, by Josh Kropf (2008/04/03)</li>
 202 </ul>
 203
 204 <ul>
 205         <li><a href="http://www.linuxjournal.com/article/10176">The BlackBerry In a World Without Windows</a>, by Carl Fink (2008/12/01)</li>
 206         <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 (2008/05/31)</li>
 207         <li><a href="http://www.linux.com/feature/123251">Syncing your Blackberry on Linux</a>, by Joe Barr (2007/12/21)</li>
 208 </ul>
 209
 210 <ul>
 211         <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>
 212         <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>
 213 </ul>
 214 </p>
 215
 216
 217 <div class="Copyright">Copyright &copy; 2011 - Net Direct Inc.</div>
 218
 219 </body>
 220 </html>
 221