There are a number of features that can be tweaked on the BibleBox.  Below are the most frequently asked “How to” questions.

How to change the BibleBox website

 Download a theme from the BibleBox Downloads page.

  1. On your BibleBox USB rename the Content folder to Content-Original
  2. Unzip the downloaded theme file
  3. Copy the Content folder from the unzipped file onto the USB to the same location as the renamed Content folder (USB – Librarybox)
  4. Wait until everything has copied
  5. safely eject the USB from your computer
  6. Plug the USB into the BibleBox and restart

How to change the SSID of the BibleBox wifi network

The default name for the BibleBox wifi network is “BibleBox files”.  To change this to something else

  • on the USB open the Config folder and edit the file – ssid.txt
  • Modify the content of this file to your desired SSID name, insert the USB back in the BibleBox device and restart.

The new network will appear once the Biblebox has fully started.

How to reset the statistics counters

To reset the Download and User statistics, delete the following two files on the USB:

  • dl_statistics.sqlite
  • vc_statistics.sqlite

Deleting these two files will reset the counts both to zero

How to enable FTP access

The BibleBox can be setup with FTP access which makes it very easy for you to transfer new files for sharing to it with being physically connected, but through the BibleBox wifi connection.

  1. Turn on the BibleBox and connect to the wifi
  2. From you computer use Terminal (OS X) or PuTTY (Win) to SSH into the Biblebox:  (remembered the Password you created earlier?)
    ssh root@
  3. Run the advance setup script (same script as used when setting up Password)
  4. Select Option 3  –
    3 - Start FTP configuration
  5. Youll see the following menu appear :
     Choose an option: 3
       Current configuration:
       FTP enabled                : yes 
       Admin access               : yes 
       Special SYNC access        : yes 
       SYNC Port                  : 54321 
       Anonymous login possible   : no 
       FTP Synchronisation active : no 
       FTP Sync hostname          : empty 
       FTP Sync password          : empty 
      1 -  Enable / Disable FTP 
      2 -  Enable / Disable Admin Access 
      3 -  Enable / Disable Sync Master 
      4 -  Enable / Disable Anonymous Access 
      5 -  Set password for Sync Master 
      6 -  Set password for Admin Access 
      7 -  Enable Sync Client 
      8 -     Client host  
      9 -     Client password  
     Enter h and a number for help about the topic. For example, h8 for Client host help
     Every other button is a clean exit.
  6. When you make a selection it will enable/disable the options, so select option 1 to enable FTP
  7. Then select Option 6 to Set a Password for your FTP access
  8. Now to exit the menu press X (or any other button) and restart the BibleBox
  9. Connect to the BibleBox wifi, run your favourite FTP app using:
    • server address
    • username – “nobody”
    • password = whatever password you created

How to change the Wifi Channel on the BibleBox

In the Config folder on the BibleBox USB, open the Text file named – channel.txt

  1. edit this text file so it only contains the number for your desired channel
  2. it is recommended to use 1, 6 or 11 as these channels are non-overlapping, reducing interference when in other wifi areas

How to change the initial Chatbox text

Using Terminal (Mac) or PuTTY (PC) app:

  1. connect your BibleBox to your computer
  2. make sure your computer has IP address
  3. use Terminal or PuTTY ssh into BibleBox ssh root@ plus your BibleBox password
  4. change the directory to the location of the chatbox file you want to modify, type:  cd /opt/piratebox/conf
  5. to modify the initial chat box content txt file type –

vi chat_init.txt

  1. press i to go into edit mode
  2. make your edit
  3. press Esc to go back to command mode
  4. type :w to save your edit, press enter/return key
  5. type :q, then press enter/return to quit editing
  6. Restart the BibleBox to apply the changes

How to change the hostname

To change the Hostname – the address seen in the URL or address bar on your wifi device – modify the content of the text file called hostname.txt and system_hostname.txt.  If you open these files (found on the USB in the Config folder) you will see BibleBox.lan, simply change this and save the text files.  Once you restart the BibleBox your changes will be actioned.

How to download the BibleBox Presentation

There is an introduction presentation available on Slideshare:

How to start with a clean install of BibleBox

Say you’ve been experimenting with different settings and just want to go back to a clean install of your BibleBox….follow these steps.  This will put on a new install of Openwrt, then the Librarybox scripts and the BibleBox config files. In the event that something just doesnt go well, you can re-flash the MR3040 with Openwrt firmware and start the installation process again.  From experience, and from research in online forums, I would confidently say that most installation errors are from not following the setup instructions and terminating processes too early. The thing that clearly shows you that the initial installation of the firmware and base libraybox files is complete, is that you can join wifi Librarybox free content SSID and browse to in your web browser and see librarybox webpages.  Once you see that you can be assured that installation is complete. If you need to – here are the instructions on how to re-flash, or re-install Openwrt, and then the rest of the opensource files.

  1. Power off the router
  2. Unplug the USB Drive from the router, and plug it into your computer
  3. reformat the USB as FAT32
  4. Download the appropriate firmware for your device:
  5. Copy the firmware version you need (eg. for version 2 device select – openwrt-ar71xx-generic-tl-mr3040-v2-squashfs-factory.bin firmware file) onto your USB Drive, making sure it is the only file on the USB
  6. Telnet in to the BibleBox using Terminal or PuTTY, and enter the commands below, insert the name of the firmware file where appropriate below (NOTE: dont forget to include the word “firmware” at the end):
        cd /mnt/usb
        mtd -r write YOUR_FIRMWARE_NAME_HERE firmware
  7. click Enter
  8. Once the firmware flash finishes (after about 15mins you will see a wifi network called Openwrt) , the BibleBox will Reboot, and put the BibleBox USB back into your computer.
  9. Download the install folder, unzip, and copy it onto the root of the USB drive. Only the folder named install (and its contents) needs to be copied
  10. Put the BibleBox USB back into the router, and power it back on. The install process should now start.
  11. Remember to wait until you can join the Librarybox free content wifi, and access the website. Thats the indicator that installation is complete
  12. Then continue from Step 17 in the BibleBox Build on the Make page

Secure the BibleBox files wifi network with WPA2 (PSK)

Using Terminal or PuTTY app:

  1. ssh into BibleBox ssh root@
root@OpenWrt:~# uci set wireless.@wifi-iface[0].encryption=psk2
root@OpenWrt:~# uci set wireless.@wifi-iface[0].key="your_password"
root@OpenWrt:~# uci commit wireless
root@OpenWrt:~# wifi

How to put the MR3040 into Failsafe Mode

Failsafe mode is useful if for some reason you’ve lost access to your MR3040.

  1. Switch on the MR3040 router
  2. Wait almost 5 sec then Press the “Reset” button for ~3sec
  3. The device is now in Failsafe-Mode
  4. You may access it by using telnet