GalleryLu

A React-based image gallery for previewing images uploaded to FileLu or AWS S3 compatible cloud storage providers.

Motivation

Click to expand

GalleryLu is my second open-source contribution to the FileLu ecosystem, following the Web Image Categorizer (WIC). While using FileLu to manage images uploaded by WIC, I identified some usability challenges. The folder navigation could be more efficient, and the image preview lacked the convenience of "next" and "previous" buttons. GalleryLu addresses these issues, providing a streamlined image browsing experience.

Starting from version 0.1.0, a file encryption feature has been added. Since FileLu does not provide settings to modify the CORS response header, I had no choice but to use Vercel's rewrite module, which acts as a reverse proxy, to bypass the CORS issue. The Vercel rewrite module is only used for encrypted images; standard images are not affected and are served directly from FileLu. As the images passing through Vercel are encrypted, I believe the current implementation remains secure.

As of version 0.2.0, GalleryLu supports the new FileLu S5 API. This API enables CORS requests by default. As a result, both standard and encrypted images are served directly from the FileLu server via a secure HTTPS connection.

Critically, user privacy is a core principle. All data processing occurs within the client's browser, and the application, hosted on Vercel, is purely static. Data transmission is strictly limited to communication with the FileLu API.

If you are new to FileLu, please consider to register by using my referral link.

Features

• Intuitive File Explorer Interface
  • Familiar folder/file structure navigation.
  • Clear visual hierarchy for folders and files.
  • Easy navigation using breadcrumbs.
  • Responsive design for various screen sizes (desktop, tablet, mobile).
• Image Preview
  • Click on image thumbnails to open a full-size preview.
  • Lightbox-style image viewer.
  • Image metadata display in lightbox view.
  • Sort images by file name or uploaded time.
• FileLu Integration
  • Seamless connection to FileLu's API using user-provided S5 / API key.
  • Secure handling of API key (client-side only, no server involved).
  • Data transfer directly between the user's browser and FileLu's servers.
• Encryption
  • Support viewing encrypted images uploaded by Web Image Categorizer.
  • Decryption is performed on client side. Password and decrypted data never transmitted outside the application.
• User Privacy
  • Data privacy is a top priority.
  • No API keys are transmitted to any third-party server other than FileLu.
  • When using FileLu S5 API:
    • All images will be downloaded directly from FileLu, which provides top-tier security.
  • When using FileLu Developer API:
    • Standard images will be downloaded from FileLu directly.
    • Encrypted images will be downloaded through the Vercel rewrite module due to CORS issue and decrypted on user's browser.
  • All processing happens client-side in the user's web browser.

Demo

gallerylu-demo.mp4

Terms of Use

By using this application, you agree to the following terms:

• Usage:
  • GalleryLu is provided for users to view images uploaded to FileLu.
• No Warranty:
  • GalleryLu is provided "as is" without any warranties, express or implied.
  • The author makes no representations or warranties in relation to the application or the information and materials provided.
• Limitation of Liability:
  • The author will not be liable for any damages arising from the use or inability to use GalleryLu.
  • This includes, without limitation, direct, indirect, incidental, or consequential damages.
• Privacy:
  • Users' data, such as files and API keys, will only be used to communicate with FileLu's API server.
  • No data will be stored or shared beyond the intended purpose.
• Modifications:
  • The author reserves the right to modify these terms at any time.
  • Any changes will be posted on this page, and continued use of the application constitutes acceptance of the updated terms.

Limitations

• GalleryLu supports common image formats only, such as .jpg, .png, .bmp, .gif, and .webp. Other files will be hidden.
• GalleryLu depends on FileLu's API. GalleryLu will not work when the API service is unavailable.
• When using FileLu Developer API:
  • FileLu does not provide an API that can list a folder's content with their direct download links. Therefore, GalleryLu has to request a download link for each image one by one. To prevent hitting the rate limit, GalleryLu may take time to load a large folder.
  • FileLu does not provide settings for CORS. The encrypted images cannot be downloaded from FileLu server directly. Vercel rewrite module is being used to bypass CORS issue. Please try FileLu S5 API without involving third-parties.

License

Licensed under the MIT license.