diff --git a/docs/README.md b/docs/README.md index de24bae..dbf856a 100644 --- a/docs/README.md +++ b/docs/README.md @@ -20,3 +20,6 @@ Items marked ```REQUIRED``` are assumed to be setup and working. You've been war * [Web Dashboard / Landing Page](landing_page.md) * [System Monitoring (REQUIRED)](monit.md) * [Resource Monitoring](munin.md) +* [Web File Manager (Picture Sync)](filebrowser.md) +* [SyncThing (Picture Sync)](syncthing.md) +* [rclone (Picture Sync)](rclone.md) diff --git a/docs/filebrowser.md b/docs/filebrowser.md new file mode 100644 index 0000000..c7798a8 --- /dev/null +++ b/docs/filebrowser.md @@ -0,0 +1,46 @@ +# Web File Manager + +The below will setup ```filebrowser``` as a file manager for your photos on the PiFrame. This is a web based application and works really well for adding and removing pictures from a PiFrame. It's a lot more accessible than some of the other options we have documented. + +## Important Notes + +* The setup below tunes ```filebrowser``` to be more resource efficient. Specifically we disable picture thumbnails and set the picture processing threads to 1. +* ```filebrowser``` can use upwards of 512Mb of memory and 4 cores of the Raspberry Pi (that's *all* of them) when generating image thumbnails and rendering images. This is why we have made adjustments below. Please keep this in mind if you make adjustments. +* ```filebrowser``` **always** re-generates thumbnails when the pictures folder is loaded. This is not ideal and another reason we have made adjustments below. Please keep this in mind if you make ajustments. + +## Setup + +``` sh + +curl -fsSL https://filebrowser.org/get.sh | bash +mkdir /home/feh/filebrowser +filebrowser -c /home/feh/filebrowser/pictures.json -d /home/feh/filebrowser/pictures.db \ + config init +filebrowser -c /home/feh/filebrowser/pictures.json -d /home/feh/filebrowser/pictures.db \ + config set --address 0.0.0.0 +filebrowser -c /home/feh/filebrowser/pictures.json -d /home/feh/filebrowser/pictures.db \ + config set --port 9191 +filebrowser -c /home/feh/filebrowser/pictures.json -d /home/feh/filebrowser/pictures.db \ + config set --branding.name "PiFrame - Pictures" +filebrowser -c /home/feh/filebrowser/pictures.json -d /home/feh/filebrowser/pictures.db \ + users add admin apassword +chown feh: -R /home/feh/filebrowser +firewall-cmd --zone=public --permanent --add-port=9191/tcp +firewall-cmd --reload +cat > /etc/systemd/system/filebrowser-pictures.service < /etc/systemd/system/filebrowser-pictures.service <