explaingit

gee1k/upic

Analysis updated 2026-07-03

★ 3,701SwiftAudience · writerComplexity · 2/5LicenseSetup · easy

TLDR

uPic is a macOS menu bar app that uploads images and files to cloud storage services and instantly copies a shareable link to your clipboard in plain URL, HTML, or Markdown format.

Mindmap

mindmap
  root((uPic))
    What it does
      Uploads images and files
      Copies link to clipboard
      Multiple output formats
    Upload triggers
      Drag and drop
      Automatic screenshots
      Clipboard paste
      Right-click Share menu
      Command line
    Storage options
      S3 and GitHub
      Imgur and Gitee
      Cloud OSS and COS
      Custom API endpoint
    Audience
      Bloggers
      Content writers
      Developers
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Drag an image onto the macOS menu bar icon to upload it and get a ready-to-paste Markdown link for a blog post in seconds

USE CASE 2

Configure uPic to upload screenshots automatically to S3 or GitHub the moment they are taken

USE CASE 3

Use the command line interface to upload images from shell scripts and capture the returned URL as a variable

USE CASE 4

Set up a right-click Share menu shortcut to upload any image from Finder to Imgur or a custom API with one click

What is it built with?

SwiftmacOS

How does it compare?

gee1k/upicapple/swift-argument-parserramotion/swift-ui-animation-components-and-libraries
Stars3,7013,7043,711
LanguageSwiftSwiftSwift
Setup difficultyeasyeasymoderate
Complexity2/52/52/5
Audiencewriterdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min
Use freely for any purpose, including commercial, as long as you retain the copyright notice (MIT).

In plain English

uPic is a macOS application for uploading images and files to cloud storage services. Its main purpose is to make sharing images faster: you upload a file and the app immediately copies a link to your clipboard, ready to paste into a blog post, chat message, or document. The link can be formatted as a plain URL, as HTML, or as Markdown, depending on what you need. The app supports a wide range of storage destinations. You can upload to Amazon S3, GitHub repositories, Gitee, Imgur, Alibaba Cloud OSS, Tencent Cloud COS, Baidu Cloud BOS, and several other services. You can also configure a custom API endpoint if your preferred storage is not on the built-in list. There are several ways to trigger an upload. You can select files through Finder, drag and drop files onto the menu bar icon, drag an image directly from a browser window, take a screenshot and have it uploaded instantly, paste something from your clipboard, or use a right-click Share menu extension from anywhere in macOS. There is also a command line interface for scripted or automated uploads. You can assign global keyboard shortcuts to most of these actions. The app lives in the macOS menu bar and shows upload progress there while a transfer is in progress. It keeps a history of past uploads so you can retrieve links from earlier sessions. uPic is available through the Mac App Store, through Homebrew, or as a direct download from the GitHub releases page. The App Store version is the most up to date. An iOS companion app also exists separately on the App Store. The project is open source and released under the MIT license.

Copy-paste prompts

Prompt 1
I want to set up uPic to upload screenshots to an AWS S3 bucket automatically. Walk me through configuring the S3 storage option with my bucket name, region, and access credentials.
Prompt 2
How do I configure uPic to upload images to a GitHub repository and get a raw URL I can embed directly in Markdown files?
Prompt 3
I want to use the uPic command line interface in a shell script to upload an image and capture the returned URL as a shell variable. Show me the exact command syntax.
Prompt 4
Set up uPic to output image links in Markdown format by default so I can paste them directly into blog posts without reformatting.
Prompt 5
How do I add a custom API endpoint to uPic so it uploads to my own self-hosted storage service instead of the built-in options?

Frequently asked questions

What is upic?

uPic is a macOS menu bar app that uploads images and files to cloud storage services and instantly copies a shareable link to your clipboard in plain URL, HTML, or Markdown format.

What language is upic written in?

Mainly Swift. The stack also includes Swift, macOS.

What license does upic use?

Use freely for any purpose, including commercial, as long as you retain the copyright notice (MIT).

How hard is upic to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is upic for?

Mainly writer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub gee1k on gitmyhub

Verify against the repo before relying on details.

Alternatives & similar repos