A graphical user interface for Box Backup
Boxi is a graphical user interface to configure, manage, and administer the Internet backup software called Box Backup by Ben Summers, available from http://www.fluffy.co.uk/boxbackup.
Box Backup is ``an open source, completely automatic on-line backup system for UNIX'' with the following advantages:
Boxi is a graphical user interface to allow easy configuration and administration of the Box Backup client, and access to files on the server.
Boxi is developed in C++ using the wxWidgets GUI toolkit, available from http://www.wxwidgets.org/. This means that it should be possible in theory to compile Boxi on Windows, Macintosh and most UNIX systems, although so far only Linux has been tested. Feedback and patches for compatibility with other systems are most welcome.
The following source code archives are available:
Boxi is distributed as source code, and must be compiled before use. It should be enough to extract the contents of the archive, and run the following commands:
./configure
make
Don't even think about installing it yet! There really isn't any point. Run ``src/boxi [-c] <config-file>'' to start the GUI. The ``-c'' option is ignored if present, and provided to comfort those more familiar with the Box Backup command-line tools, most of which use ``-c'' to specify the location of the configuration file.
This software is an experimental prerelease. Most features do not work yet. This code is purely for the benefit of interested code hackers. Caveat emptor. :-)
Separated configuration settings into Basic and Advanced, to be less intimidating for new users and to fit more easily into the available screen space.
Allow navigating into directories by double-clicking files in the server file list (similar to Windows Explorer behaviour).
Allow sorting the file list by filename, size or date, in forward or reverse order. Replaced the ``Flags'' column by ``Last Modified'' date, which is more useful.
Redraw the GUI during directory restore operations, showing progress in the status bar (current file and number of files restored).
Changed most error message dialogs to have more politically-correct titles (Boxi Error and Boxi Message).
Added the ``-c'' command-line option, which is ignored, and renamed README.txt back to README, to stop Make from complaining.
Many thanks to Richard Eigenmann for these suggestions.
Added the ability to restore files and directories from the server, and to delete and undelete directories.
Fixed many crashes due to server disconnecting during operation, and internal buffer overflows in Box Backup's debugging code.
Display file sizes (nicely formatted) in the server file list.
Split the code into multiple files (modules), which should make it easier to understand and faster to recompile after making changes.
Fixed a bug that made it impossible to connect to the server and browse files stored there, since before version 0.0.2 was released.
Missing essential configuration parameters are detected when trying to connect to the server, and a warning is given.
Exceptions are handled much better, with Real Error Messages(TM).
You can now save your changes to the configuration file by selecting the ``Save'' option from the ``File'' menu. This feature should be used with extreme caution! PLEASE back up your configuration file first!
Some of this code is very ugly. Apply flames liberally and ensure that the code is cooked through (not bleeding) before consumption.
Saving configuration files is not well tested yet. PLEASE BE CAREFUL!
Boxi should prompt to save changes if the config file is changed and you try to exit, or you have an open connection to the store daemon.
It is not yet possible to undelete files on the server, due to protocol limitations.
See the TODO file for a list of features which are planned for future releases, and feel free to contribute patches or suggestions for new features :-)
This software is copyright (C) Chris Wilson <boxi_README@qwirx.com>, 2004-05. Licensed for public distribution under the GNU General Public License (GPL), version 2 or later (http://www.gnu.org/licenses/gpl.html).
Contains a copy of Box Backup by Ben Summers, which is separately licensed under a license very similar to the BSD license, which can be seen at http://www.fluffy.co.uk/boxbackup/license.html. This component is NOT covered by the GPL.
Portions of Boxi are copied, based on or inspired by Box Backup itself, and it is not possible to compile Boxi without linking to the Box Backup code. Therefore, the Boxi code contains the attribution required by the Box Backup license, that it contains code by Ben Summers. This attribution must not be removed from the code!