Minimalist Local PicBed for MacOS

中文文档

This project introduces a minimalist local picture hosting solution (PicBed) specifically designed for macOS. It leverages the simplicity and flexibility of Flask for serving images over the web, and rumps for integrating seamlessly with the macOS menu bar.

Features:

• Support Multi-Vault management.

• Clipboard Monitoring: Automatically saves images copied to the clipboard, streamlining the process of image uploading.

• URL Copying: After an image is saved, the URL of the image is immediately copied to the clipboard, making it easy to share or embed the image elsewhere.

This PicBed solution is ideal for users seeking a straightforward and efficient method to manage and share images locally in Markdowns or Obsidian.

Install

1. Install Python
2. Build a Python environment if you need(optional)
3. Clone the repository

   git clone https://github.com/ErwinLiYH/MiniPicBedMac.git
   cd MiniPicBedMac

4. Modify settings in __init__.py

   # title of the app in status bar
   TITLE = "MyPicbed"
   
   # image saving directory
   # you can add and modify vault here
   FILES_DIRECTORY = {
   "default": os.path.expanduser('~/mypicbed/'),  # default vault in ~/mypicbed/
   # "any_other_vault": "path/to/your/vault"
   }
   
   # server port, default: 20119
   PORT = 20119
   
   # copy behavior: MD to copy markdown code to refer the image
   # URL to copy URL of the image only
   # PATH to copy the image path
   # default: MD
   COPY_BEVAIOR = "MD"  # "MD", "URL" or "PATH"

5. Install

   pip install .

Usage

1. Run PicBed

   python -m local_picbed_mac&

2. Copy a image
3. Seect vault to save image by clicking Selected Vault: xxx in status bar app(optional)
4. Click Save Image for Pastedboard in status bar app
5. Copy the image MD/URL/PATH to anywhere