XPoet/picx
Picx
Picx is a web-based image hosting tool and manager that uses GitHub repositories as the backend storage system. It functions as a personal image bed, allowing users to upload, organize, and serve images for websites, blogs, and markdown documentation.
The project differentiates itself through client-side image processing, which compresses files and applies watermarks within the browser before uploading to reduce bandwidth. It also features a rule-based URL generation system that transforms repository file paths into shareable links using customizable templates.
The application provides a management interface for directory organization, batch storage transfers, and file operations such as renaming and deleting. Users can upload assets via file selection, drag-and-drop, or by intercepting system clipboard paste events.
Access to the service and the underlying image repositories is managed through GitHub authentication and token-based authorization.
Features
- GitHub API Persistence - Uses a GitHub repository as the primary backend filesystem for hosting and retrieving image files.
- Personal Image Beds - Functions as a personal image bed for storing and organizing images for web use.
- Share Link Generation - Generates shareable image links in multiple formats using customizable URL rules.
- GitHub Image Hosting - Provides a dedicated interface for hosting and serving images via GitHub repositories.
- Image Asset Management - Organizing visual files into folders and applying compression or watermarks before deploying them to a public URL.
- GitHub Integration Tools - Offers a tool for uploading and managing images stored in GitHub repositories.
- Client-Side Compression - Provides client-side image compression within the browser to reduce upload bandwidth and storage usage.
- Image File Managers - Provides a central interface for previewing, renaming, and deleting hosted images.
- URL Transformation Rules - Transforms raw repository file paths into shareable links using customizable formatting templates.
- Web-Based Image Hosts - Provides a web application for hosting images and generating shareable URLs for blogs and forums.
- Markdown Image Link Templates - Generates formatted Markdown image links for quick embedding into documentation and blog posts.
- GitHub API Integrations - Provides a management interface using the GitHub API to organize, rename, and delete hosted images.
- Remote Repository Folder Mapping - Simulates a multi-level directory hierarchy to organize images within the remote GitHub repository.
- Watermarking - Applies watermarks to protect visual content and compresses file sizes before upload.
- GitHub Authentication - Implements a login mechanism using GitHub authorization tokens to access image hosting features.
- Token-Based Authentication - Uses GitHub authorization tokens to validate user access and manage private repository permissions.
- Directory-Based Organization - Implements a multi-level folder structure for categorizing and locating hosted image files.
- Multi-Method Uploads - Supports multiple image ingestion methods including file selection, drag-and-drop, and clipboard pasting.
- Image Optimization Tools - Includes utilities to compress image files and add watermarks before uploading to storage.
