X-Git-Url: https://git.p6c8.net/jirafeau_project.git/blobdiff_plain/1adc7273904dc3be64b309739d9eb9ecdbd67622..4ce96e7519f384ccd7e232db2802aa704636a560:/README.md?ds=inline diff --git a/README.md b/README.md index 37fdfc7..f48f4cc 100644 --- a/README.md +++ b/README.md @@ -1,18 +1,18 @@ # Jirafeau +![Build Status](https://img.shields.io/gitlab/pipeline/mojo42/Jirafeau/master.svg) +![Made With](https://img.shields.io/badge/made_with-php-blue.svg) +![License](https://img.shields.io/badge/license-agpl--3.0-blue.svg) +![Contribution](https://img.shields.io/badge/contributions_welcome-brightgreen.svg?labelColor=brightgreen) + Welcome to the official Jirafeau project, an [Open-Source software](https://en.wikipedia.org/wiki/Open-source_software). -Jirafeau allows your to "one-click-filesharing". It makes possible to upload a file in a simple way and give an unique link to it. +Jirafeau is a "one-click-filesharing": Select your file, upload, share a link. That's it. -A demonstration of the latest version is available on [jirafeau.net](https://jirafeau.net/). +See [jirafeau.net](https://jirafeau.net/) for a demo. ![Screenshot1](http://i.imgur.com/TPjh48P.png) -Latest CI Status: -Master [![Build Status Master](https://gitlab.com/mojo42/Jirafeau/badges/master/build.svg)](https://gitlab.com/mojo42/Jirafeau/commits/master) -Next Release [![Build Status Next Release](https://gitlab.com/mojo42/Jirafeau/badges/test/build.svg)](https://gitlab.com/mojo42/Jirafeau/commits/master) -[All Branch Builds](https://gitlab.com/mojo42/Jirafeau/pipelines?scope=branches) - ## Main features - One upload → One download link & one delete link @@ -20,6 +20,7 @@ Next Release [![Build Status Next Release](https://gitlab.com/mojo42/Jirafeau/ba - Shows progression: speed, percentage and remaining upload time - Preview content in browser (if possible) - Optional password protection (for uploading or downloading) +- option to require, check or generate file download passwords - Set expiration time for downloads - Option to self-destruct after first download - Shortened URLs using base 64 encoding @@ -74,12 +75,17 @@ Installation steps: - B) Setup without the installation wizard (cli): - Just copy ```lib/config.original.php``` to ```lib/config.local.php``` and customize it +💡 Hint: How to +[install & configure Jirafeau](https://www.howtoforge.com/how-to-setup-a-file-sharing-website-with-jirafeau-on-debian-10/) +on Debian 10 from scratch, with Nginx and PHP-FPM. + ### Troubleshooting If you have some troubles, consider the following cases - Check your ```/lib/config.local.php``` file and compare it with ```/lib/config.original.php```, the configuration syntax or a parameter may have changed - Check owner & permissions of your files +- set `debug` option to `true` to check any warning or error ## Security @@ -205,6 +211,8 @@ Hint: To create a custom theme just copy the »courgette« folder and name your ### I found a bug, what should I do? Feel free to open a bug in the [GitLab's issues](https://gitlab.com/mojo42/Jirafeau/issues). +If you can, please copy-paste informations related to bug opening provided in admin interface. +Admin interface can be reached by accessing `/admin.php`. ### How to set maximum file size? @@ -266,7 +274,7 @@ Check [issues](https://gitlab.com/mojo42/Jirafeau/issues) to check open bugs and ### What about this file deduplication thing? -Jirafeau uses a very simple file level deduplication for storage optimization. +Jirafeau can use a very simple file level deduplication for storage optimization. This mean that if some people upload several times the same file, this will only store one time the file and increment a counter. @@ -276,9 +284,11 @@ When the counter falls to zero, the file is destroyed. In order to know if a newly uploaded file already exist, Jirafeau will hash the file using md5 by default but other methods are available (see `file_hash` documentation in `lib/config.original.php`). +This feature is disabled by default and can be enabled through the `file_hash` option. + ### What is the difference between "delete link" and "delete file and links" in admin interface? -As explained in the previous question, files with the same hash are not duplicated and a reference counter stores the number of links pointing to a single file. +When file deduplication feature is enabled, files with the same hash are not duplicated and a reference counter stores the number of links pointing to a single file. So: - The button "delete link" will delete the reference to the file but might not destroy the file. - The button "delete file and links" will delete all references pointing to the file and will destroy the file. @@ -286,3 +296,9 @@ So: ### How to contact someone from Jirafeau? Feel free to create an issue if you found a bug. + +Also, you can come have a chat on [libera.chat](https://web.libera.chat/) in `#jirafeau` channel. + +### Can I buy you a coffee? + +You can [drop few bucks](https://www.paypal.com/paypalme/jeromejutteau) to help the [demo web site](https://jirafeau.net) to stay alive.