Skip to content

AlexArendsen/sandpiper

Repository files navigation

Sandpiper

PHP + MySQL Flat File Server and Web App


What is Sandpiper?

NOTE: Sandpiper is still in development. Use at your own risk.

Sandpiper Dashboard

Sandpiper is a simple, flat, and responsive web app for uploading and downloading your files. It has a minimalist web interface built with MaterializeCSS and AngularJS that let you quickly search through and manage your uploads.

  • Simple: Sandpiper strives to accomplish the goal of hosting files through a web interface with as few frills as possible.
  • Flat: To keep things simple, folders are intentionally omitted from Sandpiper. Instead, files are described using text tags.
  • Responsive: The Sandpiper UI is built on MaterializeCSS, making it just as usable on mobile devices as it is on desktop.

Dependencies & Installation

Sandpiper is designed for and tested on LAMP configurations. The following dependencies are provided for installations on LAMP platforms:

  • Apache >= 2.4.7 (not tested on previous versions)
    • Rewrite module (mod_rewrite) enabled
    • .htaccess permission allowed
  • PHP >= 5.5
    • mysqli extension enabled
    • gd extension enabled, >=1.8
  1. Place into desired server directory.
  2. Go to install/, run easy_install.sh and follow the prompts.
  3. Run new_user.sh to create an administrative user.
  4. Copy config.php.example to config.php, and edit the MySQL connection arguments therein.
  5. Ensure that your server user (eg, www-data or http) and group have read and write permissions in the uploads/ directory and everything within it
  6. Run bower install to download the necessary dependencies.
  7. Create a scheduled job on your server to empty the uploads/.trash directory on a regular interval.

Log into the web interface with the login credentials you supplied in the easy_install.sh script. User accounts may be managed through the web interface.

Credit

Sandpiper by Alex Arendsen, licensed under GPLv2.0 (see LICENSE).

File type icons found in static/img/filetypes is Teambox's Free-file-icons, licensed under the MIT license.

CAPTCHA is provided by Claviska's simple-php-captcha. It is licensed under the MIT license.

Front-end hashing provided by nevins-b's javascript-bcrypt, which includes Yves-Marie K. Rinquin's random number generator issac.js.

About

PHP + MySQL Flat File Server and Web App

Resources

License

Stars

Watchers

Forks

Packages

No packages published