Config Options

On the USB drive under the LibraryBox folder, there is a folder named "Config" that is full of text files. This includes:

channel.txt

hostname.txt

librarybox_ftp.txt

librarybox_ftpadmin.txt

librarybox_ftpanon.txt

librarybox_ftpsync.txt

librarybox_ftpsyncport.txt

librarybox_shoutbox.txt

ssid.txt

system_hostname.txt

txpower.txt

Some of these are controlled by the menus mentioned above in the FTP setup, but several of them allow you to customize your LibraryBox. You can change the value of:

channel.txt to reflect the wifi channel that you want the LibraryBox to use

system_hostname.txt if you'd like a custom hostname when setting up Sync Clients

ssid.txt if you want to have a custom wifi ssid to be broadcast

txpower.txt if you'd like to make your LibraryBox have just a bit more (or a bit less) oomph when it comes to wifi coverage. The default is 25, but ranges between 20-30 should be safe (although raising the TX power will result in significantly higher power consumption and heat generation by the MR3020. If you make any changes to these files, they will take effect the next time you boot your LibraryBox. I would recommend NOT changing the various FTP settings in this way, stick to the config files mentioned above.

MiniDLNA Setup

Connect to the LibraryBox SSID with your computer, and SSH into it:



ssh root@192.168.1.1

box_init_setup.sh

1 - Setting password and enable SSH 2 - Set date & time (enable timesave) 3 - Start FTP configuration 4 - minidlna enable

FTP Setup

Run the LibraryBox advance setup script:which will give you the following menu:Simply select 4, and hit return. Your LibraryBox is now a DLNA server and should be discoverable by any DLNA client. The setting is saved across reboots, so the next time you power up your LibraryBox, the miniDLNA server will be active.

Setting up your LibraryBox for FTP will allow you to upload, download, and delete files from the "Shared" directory from a computer connected to the wifi signal, without having to physically interact with the LibraryBox or the USB drive. Once you have it setup, you will be able to use any FTP software to login and change the Shared files. Follow the steps below to enable FTP access on your LibraryBox.

Connect to the LibraryBox SSID with your computer, and SSH into it:

ssh root@192.168.1.1 Run the LibraryBox advance setup script:

box_init_setup.sh which will give you the following menu: 1 - Setting password and enable SSH 2 - Set date & time (enable timesave) 3 - Start FTP configuration 4 - minidlna enable This time, we are looking for option 3 on that menu, Start FTP Configuration.

Selecting 3 will give you one more menu, this one a bit more complicated. First, I'll walk you through setting up just FTP access, and then below we'll worry about Sync and other options. The second menu looks like this: 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.

The list above the selections show you the current status of the settings, and choosing any selection will cause the menu to re-draw to show you the new current settings. They are not applied, however, until you exit the menu and reboot your LibraryBox. To enable FTP, choose Option 1. You must also set a password for your FTP access, done by selecting Option 6 - Set password for Admin Access. Choose a secure password for your FTP access! After you have set the password, exit the menu by pressing any key. Then, reboot your LibraryBox by unplugging and plugging it back in. At this point, you should be able to connect to the LibraryBox SSID, and use any popular FTP program to connect using your password and the username "nobody".

Sync Setup

A brief word about Mesh/Sync: due to technical limitations and an effort to ensure good user experience in regards to battery life, we've implemented this first Sync protocol to be Master/Client oriented rather that true peer-to-peer mesh. We are going to continue to look at more robust sync services for LibraryBox, but for this release, the Sync works like this:

You will designate one LibraryBox to be the Master box, and any number you wish as the Clients. The Client Boxen will search for a Master every 7 minutes, just looking to see if there is one in range. If a Client sees a Master that has the appropriate login credentials, it will start a comparison and sync with the Master in question. The Client will mirror the Master in content, both in deletions and additions. In order to automagically change the Shared folder on remote LibraryBoxen, you can set up a single Master that stays with you, and you can wander into range of your installed LibraryBoxen, hang out for a few minutes, and move on.

To set up Sync, follow these direction:

Connect to the LibraryBox SSID with your computer, and SSH into it:

ssh root@192.168.1.1 Run the LibraryBox advanced setup script:

box_init_setup.sh which will give you the following menu: 1 - Setting password and enable SSH 2 - Set date & time (enable timesave) 3 - Start FTP configuration Choose option 3 on that menu, Start FTP Configuration.

Selecting 3 will give you one more menu, this one a bit more complicated. 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.

The list above the selections show you the current status of the settings, and choosing any selection will cause the menu to re-draw to show you the new current settings. They are not applied, however, until you exit the menu and reboot your LibraryBox.

Set Up a Master LibraryBox

Disable FTP Set Password for Sync Master Enable Sync Master Exit the menu by choosing any other key. Run the command: /etc/init.d/mesh enable Run the command: /etc/init.d/piratebox avahi Reboot your LibraryBox, and now you have a Master, ready for connections to Client Boxen.

Set Up a Client LibraryBox