Awesome
vs-picgo
The VSCode extension of PicGo.
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
<details> <summary>Uploading an image from clipboard</summary> <img src="https://i.loli.net/2019/04/09/5cac17d2d2265.gif" alt="clipboard.gif"> </details> <details> <summary>Uploading images from explorer</summary> <img src="https://i.loli.net/2019/04/09/5cac17eea0d65.gif" alt="explorer.gif"> </details> <details> <summary>Uploading images from input box</summary> <img src="https://i.loli.net/2019/04/09/5cac17fe52a86.gif" alt="input box.gif"> </details> <details> <summary>Use selection text as the uploaded <code>fileName</code></summary> <img src="https://i.loli.net/2019/04/09/5cac180fb1dc7.gif" alt="selection.gif"> <b>Notice: These characters: <code>\$</code>, <code>:</code>, <code>/</code>, <code>?</code> and newline will be ignored in the image name. </b>(Because they are invalid for file names.) </details>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 | <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>U</kbd> | <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>E</kbd> | <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>O</kbd> |
OsX | <kbd>Cmd</kbd> + <kbd>Opt</kbd> + <kbd>U</kbd> | <kbd>Cmd</kbd> + <kbd>Opt</kbd> + <kbd>E</kbd> | <kbd>Cmd</kbd> + <kbd>Opt</kbd> + <kbd>O</kbd> |
Settings
-
Default
- The default image hosting is SM.MS.
-
Custom
<details> <summary><b>BIG NEWS: from 2.0.0, We can customize the settings in VSCode settings</b></summary> <img src="https://i.loli.net/2019/04/09/5cac1821b6621.png" alt="vscode-setting.png"> </details>-
Use an external configuration file
<details> <summary>Enter the path of the configuration file</summary> <img src="https://i.loli.net/2019/04/09/5cac1836598a8.png" alt="external-config.png"> </details> -
Use VSCode settings
<details> <summary>First, choose the current PicBed</summary> <img src="https://i.loli.net/2019/04/09/5cac1847b5907.png" alt="current-picbed.png"> </details> <details> <summary>Then, input all the info the current PicBed needs</summary> <img src="https://i.loli.net/2019/04/09/5cac4950d176b.png" alt="picbed-info.png"> </details> <details> <summary>Customize the name of the image to be uploaded</summary> <b>Notice: If you selected some text before uploading, the selection will become the <code>fileName</code> of the image to be uploaded.</b> <img src="https://i.loli.net/2019/04/09/5cac189446749.png" alt="image-name.png"> </details> <details> <summary>Customize the output format of the uploaded image</summary> <img src="https://i.loli.net/2019/04/09/5cac18a5c9def.png" alt="output-format.png"> </details> <details> <summary> Suggested settings for <a href='https://github.com/Molunerfinn/PicGo'>PicGo-electron</a> users (See <a href='https://picgo.github.io/PicGo-Doc/zh/guide/config.html#%E9%85%8D%E7%BD%AE%E6%89%8B%E5%86%8C'> PicGo configuration path</a> for more information): </summary> </details>Notice:
YOUR_HOME_DIR
should be replaced by the path of your current user path.
<details> <summary><code>picgo.configPath</code> and <code>picgo.dataInfoPath</code> can be set in vscode settings</summary> <img src="https://i.loli.net/2019/04/09/5cac19421ddf5.png" alt="for-picgo-user.png"> </details>// 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" }
In this way:
vs-picgo
will use the same configuration asPicGo-electron
.PicGo-electron
will display all the uploaded images byvs-picgo
in its gallery.
-
Migration
- From ^1.0.0 to ^2.x
- External configuration file property has changed, from
picgo.path
topicgo.configPath
.
- External configuration file property has changed, from
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!