Skip to content

PicGo/vs-picgo

Repository files navigation

vs-picgo

The VSCode extension of PicGo.

version Visual Studio Marketplace Rating installs Build Status Coveralls github branch GitHub stars PicGo Convention JavaScript Style Guide

Overview

vs-picgo is a VSCode extension for uploading images to a remote image hosting service and insert the url into the current editing file. It's much more efficient than other tools. And it can give us the better experience of uploading images. vs-picgo supports 8 kinds of image hosting services: weibo, qiniu, tcyun, upyun, github, aliyun, imgur and SM.MS, which are supported by PicGo-Core. And the plugin feature of PicGo-Core is working in progress.

Features

Uploading an image from clipboard clipboard.gif
Uploading images from explorer explorer.gif
Uploading images from input box input box.gif
Use selection text as the uploaded fileName selection.gif Notice: These characters: \$, :, /, ? and newline will be ignored in the image name. (Because they are invalid for file names.)

Keyboard shortcuts

You can change all the shortcuts below as you wish.

OS Uploading an image from clipboard Uploading images from explorer Uploading an image from input box
Windows/Unix Ctrl + Alt + U Ctrl + Alt + E Ctrl + Alt + O
OsX Cmd + Opt + U Cmd + Opt + E Cmd + Opt + O

Settings

  • Default

    • The default image hosting is SM.MS.
  • Custom

    BIG NEWS: from 2.0.0, We can customize the settings in VSCode settings vscode-setting.png
    • Use an external configuration file

      Enter the path of the configuration file external-config.png
    • Use VSCode settings

      First, choose the current PicBed current-picbed.png
      Then, input all the info the current PicBed needs picbed-info.png
      Customize the name of the image to be uploaded Notice: If you selected some text before uploading, the selection will become the fileName of the image to be uploaded. image-name.png
      Customize the output format of the uploaded image output-format.png
      Suggested settings for PicGo-electron users (See PicGo configuration path for more information):

      Notice: YOUR_HOME_DIR should be replaced by the path of your current user path.

      // Windows
      {
          "picgo.configPath":"YOUR_HOME_DIR\\AppData\\Roaming\\PicGo\\data.json",
          "picgo.dataPath": "YOUR_HOME_DIR\\AppData\\Roaming\\PicGo\\data.json"
      }
      
      // macOS
      {
          "picgo.configPath": "YOUR_HOME_DIR/Library/Application Support/picgo/data.json",
          "picgo.dataPath": "YOUR_HOME_DIR/Library/Application Support/picgo/data.json"
      }
      
      // Linux
      {
          "picgo.configPath": "YOUR_HOME_DIR/.config/picgo/data.json",
          "picgo.dataPath": "YOUR_HOME_DIR/.config/picgo/data.json"
      }
      picgo.configPath and picgo.dataInfoPath can be set in vscode settings for-picgo-user.png

      In this way:

      1. vs-picgo will use the same configuration as PicGo-electron.
      2. PicGo-electron will display all the uploaded images by vs-picgo in its gallery.

Migration

  • From ^1.0.0 to ^2.x
    • External configuration file property has changed, from picgo.path to picgo.configPath.

Versioning

For the versions available, see the tags on PicGo/vs-picgo. ChangeLogs can be found at CHANGELOG.md. All the dev builds can be found on GitHub Actions, and you can just open the build of a specific commit, and go to the Summary tab to download the artifacts.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Contributors

Thanks

Enjoy!