PicX - GitHub Image Hosting Tool

PicX — Free & Open-Source Image Hosting Tool Based on GitHub

PicX (picx.xpoet.cn) is a free, secure, and open-source image hosting tool developed by XPoet, powered by the GitHub API and released under the AGPL-3.0 license. This page is the official PicX documentation, covering all features in detail. No download or installation is required — it runs entirely in the browser, with all sensitive data (tokens, user info, images) stored client-side for maximum security.

Login Methods

• GitHub OAuth Login: Install the PicX GitHub APP, then authorize with one click. The system automatically completes the image hosting configuration and redirects to the upload page.
• GitHub Token Login: Manually create a GitHub Token with repo permissions, enter it to log in, then click "One-Click Setup" to auto-initialize the repository and branch.

Image Hosting Configuration

Upon login, PicX automatically creates a GitHub repository named picx-images-hosting (branch: master) and completes the initial setup. Since v3.0, custom repository and branch selection is no longer supported in favor of a unified built-in configuration. Users requiring custom repos can use PicX v2.0, or use the built-in image migration feature to transfer images to the new repository.

Image Uploading

• Multiple Selection Methods: Supports drag-and-drop onto the upload area, clipboard paste (Ctrl/Command + V), and local file browsing.
• Keyboard Shortcut Upload: Press Ctrl + S (Windows) or Command + S (macOS) to trigger upload instantly.
• Auto Copy Link: After a successful upload, PicX automatically copies the image link to the clipboard for immediate use.

Image Toolbox

• Image Compression: Compress images online to reduce file size and improve loading performance.
• Image to Base64: Convert images into Base64-encoded strings for embedding in HTML/CSS or API data transmission.
• Image Watermark: Add custom text or image watermarks to photos for copyright protection.

Key Highlights

• Completely Free: Leverages GitHub's free repository storage with no fees of any kind.
• Secure & Reliable: All sensitive data is stored client-side only, never passing through third-party servers. Fully open-source and auditable.
• Cross-Platform, No Install: Runs entirely in the browser on any operating system — no client download required.