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.
- On your BibleBox USB rename the Content folder to Content-Original
- Unzip the downloaded theme file
- Copy the Content folder from the unzipped file onto the USB to the same location as the renamed Content folder (USB – Librarybox)
- Wait until everything has copied
- safely eject the USB from your computer
- 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.
- Turn on the BibleBox and connect to the wifi
- From you computer use Terminal (OS X) or PuTTY (Win) to SSH into the Biblebox: (remembered the Password you created earlier?)
ssh root@192.168.1.1
- Run the advance setup script (same script as used when setting up Password)
box_init_setup.sh
- Select Option 3 –
3 - Start FTP configuration
- 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.
- When you make a selection it will enable/disable the options, so select option 1 to enable FTP
- Then select Option 6 to Set a Password for your FTP access
- Now to exit the menu press X (or any other button) and restart the BibleBox
- Connect to the BibleBox wifi, run your favourite FTP app using:
- server address 192.168.1.1
- 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
- edit this text file so it only contains the number for your desired channel
- 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:
- connect your BibleBox to your computer
- make sure your computer has IP address 192.168.1.2
- use Terminal or PuTTY ssh into BibleBox ssh root@192.168.1.1 plus your BibleBox password
- change the directory to the location of the chatbox file you want to modify, type: cd /opt/piratebox/conf
- to modify the initial chat box content txt file type –
vi chat_init.txt
- press i to go into edit mode
- make your edit
- press Esc to go back to command mode
- type :w to save your edit, press enter/return key
- type :q, then press enter/return to quit editing
- 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:
- BibleBox on slideshare.
- Download Powerpoint file from here – BibleBox Powerpoint
- Spanish version PDF of BibleBox Presentation
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 192.168.1.1 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.
- Power off the router
- Unplug the USB Drive from the router, and plug it into your computer
- reformat the USB as FAT32
- Download the appropriate firmware for your device:
- MR3040 – Version 2 firmware – openwrt-ar71xx-generic-tl-mr3040-v2-squashfs-factory.bin
- MR3040 – Version 1 firmware
- 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
- 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
- click Enter
- 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.
- 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
- Put the BibleBox USB back into the router, and power it back on. The install process should now start.
- Remember to wait until you can join the Librarybox free content wifi, and access the website. Thats the indicator that installation is complete
- 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:
- ssh into BibleBox ssh root@192.168.1.1
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.
- Switch on the MR3040 router
- Wait almost 5 sec then Press the “Reset” button for ~3sec
- The device is now in Failsafe-Mode
- You may access it by using telnet 192.168.1.1