PhpDev.App
outdoorbits/little-backup-box

outdoorbits/little-backup-box

Stars: 452

Forks: 96

Pull Requests: 64

Issues: 105

Watchers: 30

Last Updated: 2023-09-16 10:19:47

#raspberry-pi #backup #photography #camera #backup-device

This software turns a single-board computer into a versatile, pocket-sized backup solution. Especially for digital photography, this is the solution for backing up images and media files on mass storage devices when traveling or at events. Media content can be viewed and rated for the subsequent process.

License: GNU General Public License v3.0

Languages: Shell, PHP, CSS, JavaScript, Python, Hack, HTML

http://littlebackupbox.com

Little Backup Box

About


Little Backup Box in its 3D printed case

This software turns a single-board computer into a versatile, pocket-sized backup solution.
Especially for digital photography, this is the solution for backing up images and media files on mass storage devices when traveling or at events.
Media content can be viewed and rated for the subsequent process.

These languages are already available. Do you want to maintain or create a translation?

Jump to installation instructions

NEWS

  • 2023/08/24: Little Backup Box core files are nearly totally rewritten to python. This is a major step and the new version might be not stable yet but final tests have been very successfully. In installation instructions you find how to get this version. Please test and report. Thank you!
  • 2023/05/15: There is a printable case now! Look at outdoorbits/case-for-little-backup-box
  • 2023/04/14: Introducing support for hardware buttons including a display-menu to control a wide range of lbb's functions. Read more in the Wiki.
  • 2023/04/01: Add support for Apple file systems HFS and HFS Plus. Supported file systems now are Ext2, Ext3, Ext4, FAT, vFAT, exFAT, NTFS, HFS and HFS Plus.
  • 2023/02/28: Add support for multiple displays, I2C and SPI
  • 2023/02/24: Add VPN support for WireGuard and OpenVPN
  • 2023/02/15: Remove miniDLNA due to security concerns
  • 2023/02/15: Settings: Use global password as WiFi-password in comitup-hotspot-mode
  • 2022/12/12: View got magnifying glass-function. This allows quick ratings with improved evidence.
  • 2022/12/03: Rating function supports writing of EXIF-data into media-files. This allows to use the ratings in futher processing (e.g. in darktable).
  • 2022/11/19: Image-viewer "View" now can handle videos and audios! IMPORTANT: ALL THUMBNAILS HAVE TO BE CREATED AGAIN AFTER THIS UPDATE! PLEASE DELETE ALL TIMS-FOLDERS ON YOUR STORAGE.
  • 2022/11/14: Image-viewer "View" got a rating function. Images having one star only can be deleted.
  • 2022/11/08: Image-viewer mejiro is replaced by a integrated solution offering much faster options to find images.
  • 2022/10/14: Add f3probe to tools to test external storages integrity before use.
  • 2022/10/09: Rework of the progress-monitoring to save traffic and increase speed.
  • 2022/10/03: If checked in settings, thumbnails will be generated after backup.
  • 2022/10/03: If checked in settings, the LCD display will be turned off before shutdown.
  • 2022/10/01: The Wifi country code can now be set in the settings.
  • 2022/09/24: A disk formatting function has been added to the tools.
  • 2022/04/03: A secondary default backup mode has been added. This allows you to configure a automatically starting network backup after a local backup.
  • 2022/01/16: The Wiki explains now, how to connect a LCD-display.
  • 2022/01/12: Camera-backup: Paths to backup can be configured for each device.
  • 2022/01/08: Add option to backup only specific directories from cameras or smartphones.
  • 2022/01/08: Uploads to the box can be done by the filemanager now.
  • 2021/12/31: Add language support for display-messages*1
  • 2021/12-27: Add power-off after idle time. Configuration in "Settings".
  • 2021/12/21: Add language support to the web-UI for French, Spanisch and German*1
  • 2021/12/13: There is a menue based update-function.
  • 2021/12/18: Select color-themes and background-images. Design is more colorful now to make orientation easier.
The display while a backup
from camera to usb and
from usb to rsync-server.

Some major development steps:

  • Image-viewer mejiro is replaced by an integrated solution offering much faster options to find images.
  • Multiple cloud-services can be used as storage. Check for rclone in the settings.
  • Mounting devices is managed by UUIDs. If a device disconnects*2, it can be automatically reconnected. The backup-process becomes much more robust.
  • Some tools are added (check device, repair device)
  • Installation of comitup is automated
  • It has a full powered webserver now, TLS as standard
  • Setup is form-based
  • Setup can be ex- and imported as zip-file.
  • Web interface and Samba-Server can be configured for password-protection
  • sync to your rsync-server is possible

... a lot of stuff! Please let me know about problems.

*1) Caution: The translations were carried out by machine and could cause unpleasant feelings in native speakers. Help is particularly welcome here. Technically, working on the language files is extremely easy. Would you help?
*2) Maybe because of power-failures sometimes the connection to a device is disrupted. After reconnecting, it gets a new drive-identifier (e.g. sda becomes sdb) while the drives UUID is still the same.

The web UI

The web UI on a smartphone. Full function in pocket-size.

Developement status

Little Backup Box is still under construction.
Please test your Installation carefully before productive use!
Final tests offered minor bugs (fixed), it looks good for the moment!
Little Backup Box has undergone massive development over the past few months. At the moment, no further major innovations are planned. Instead, the focus should now be on finding and correcting any errors and making the system even more reliable.
Hence the request: Test, test, test!
Please give feedback on problems or translation errors but also on the successful use, if possible with details of your equipment.

Please mind the wiki!

As there is no manual available anymore, the github-wiki should replace it one day: https://github.com/outdoorbits/little-backup-box/wiki. It's not particularly detailed yet, but it can certainly help with the most common questions.

Installation

  1. Create a bootable SD card with the latest version of Raspberry Pi OS Lite (32 or 64 bit) for use with Little Backup Box.
    An easy way is to use Raspberry Pi Imager. Please select "Raspberry Pi OS (other)" > "Raspberry Pi OS Lite (32-bit)" or "Raspberry Pi OS Lite (64-bit)".
    In Raspberry Pi Imager you can define options for your image. Shift+Ctrl+x opens the options-dialog. Here you can ...
    • enable ssh
    • change the password for user pi (standard password is "raspberry")
    • define wifi settings
  2. If you couldn't activate ssh in the previous step, just add an empty (text-)file "ssh" to the new boot-partition to enable ssh.
  3. Do not change any more settings (language!).
  4. Make sure that your Raspberry Pi is connected to the internet.
  5. login to your Raspberry Pi. If you are using ssh, there is a report about problems using WINSCP. While WINSCP itself uses putty, it's reported to work with native putty.
  6. Run the following command on the Raspberry Pi:
    curl -sSL https://raw.githubusercontent.com/outdoorbits/little-backup-box/main/install-little-backup-box.sh | bash 2> install-error.log

    To install the development branch run this command on the Raspberry Pi:
    curl -sSL https://raw.githubusercontent.com/outdoorbits/little-backup-box/development/install-little-backup-box.sh | bash -s -- development 2> install-error.log

    Errors are reported into ./install-error.log.
  7. You will be asked for the default backup mode.
    This is the action started automatically after boot.
  8. You will be asked if you want to install comitup.
    The comitup service establishes wifi connectivity for a headless Linux system, using wifi as the only access mechanism to the system. Access the box by its own wifi hotspot or connect it to a local wifi access point.
  9. Don't worry: Please note this in case you installed via wifi/ssh and decided to install comitup. If your installation-screen scrolls down and seems to freeze at something like Setting up python3-networkmanager (2.2-1) ..., this doesn't mean anything went wrong. Comitup is installed at the end of the process and when it's comming up, it changes your wifi-network. Your ssh-session is broken and you will not get any more information. In the background the installation finishes and a few seconds later the pi reboots. What you can't see anymore is a short information, how to access Little Backup Box. In your setting, this would be the information you need:

    ******************************************************************************************
    *** How to proceed:
    ***
    *** Your raspberrys wifi-configuration has been removed by comitup now. Because comitup has no
    *** access-data for your wifi yet, it can't connect to it and will start as a wifi-hotspot:
    *** ssid=little-backup-box-nnnn (nnnn is a random number).
    ***
    *** Please connect your mobile or notebook to this wifi.
    ***
    *** There are two options now:
    ***
    *** 1. If you want to configure comitup now, navigate to http://10.41.0.1 (http, not https!)
    *** and connect your lbb to your wifi.
    *** Connect your mobile or notbook to the same wifi. If you use a display on your lbb, it will
    *** tell you its new IP. Connect to lbb:
    *** https://IP.IN.YOUR.WIFI (secure, certificate can't be verified automatically, please confirm it)
    *** http://IP.IN.YOUR.WIFI:8000 (insecure)
    ***
    *** 2. Alternatively can reach the web UI of Little Backup Box when you are connected to its
    *** hotspot as follows:
    ***
    *** https://10.41.0.1 (secure, certificate can't be verified automatically, please confirm it)
    *** http://10.41.0.1:8000 (insecure)
    ***
    *** Please use the settings of the web UI to optimally adapt the Little Backup Box for you.
    ***
    *** If you have further questions, please check the wiki first:
    *** https://github.com/outdoorbits/little-backup-box/wiki
    ***
    *** We are always happy to receive your feedback!
    ******************************************************************************************

Image-viewer View

Start

If everything went well, it's done! Open a browser and enter https://IP.OF.YOUR.BOX or http://IP.OF.YOUR.BOX:8000
Have fun!

Update

  • Updates can be carried out quickly and easily via the WebUI. Just follow the instructions in the wiki.
  • Alternatively just login via ssh and execute the installation-command from above. It will run in update-mode.

Contribute

  • If you've found a bug or have suggestions for improvements, open an issue in the Issues section.
  • If you could spend a bit of time and add a new language - great, just tell me, it's easy!
  • To add new features or fix issues yourself, follow the following steps.
  1. Open an issue to discuss your idea.
  2. Fork the project's repository.
  3. Create a feature branch using the git checkout -b new-feature command.
  4. Add your new feature or fix bugs and run the git commit -am 'Add a new feature' command to commit changes.
  5. Push changes using the git push origin new-feature command.
  6. Submit a pull request (in your fork at github.com).

Authors

Stefan Saam, founder is Dmitri Popov. He has entrusted me with the further maintenance of Little Backup Box. Thank you Dima for this great project.

Contributors

  • Dmitri Popov
  • Kerry Staite (STL files)
  • munecito (corrections of the Spanish translation)

License

The GNU General Public License version 3

OPEN ISSUES

See all

RELEASES

See all