From 24100441611425cdcbe555ac33e429a86f451604 Mon Sep 17 00:00:00 2001 From: James Ravenscroft Date: Sun, 30 Jul 2023 15:36:50 +0100 Subject: [PATCH] add picgo post --- brainsteam/content/posts/2023/07/30/picgo.md | 108 +++++++++++++++++++ 1 file changed, 108 insertions(+) create mode 100644 brainsteam/content/posts/2023/07/30/picgo.md diff --git a/brainsteam/content/posts/2023/07/30/picgo.md b/brainsteam/content/posts/2023/07/30/picgo.md new file mode 100644 index 0000000..7e30650 --- /dev/null +++ b/brainsteam/content/posts/2023/07/30/picgo.md @@ -0,0 +1,108 @@ +--- +title: "TIL: PicGo" +date: 2023-07-30T12:33:40+01:00 +draft: true +description: Using PicGo to quickly upload photos to my site +url: /2023/7/30/til-picgo +type: post +mp-syndicate-to: +- https://brid.gy/publish/mastodon +thumbnail: https://brainsteam.co.uk/media/2023/07/202307301533057.png +tags: + - post + - TIL + - indieweb + - opensource +--- + +Today I learned about [PicGo](https://github.com/Molunerfinn/PicGo) an open source project which provides a relatively lightweight tool (it is an electron app so... 😬) which runs in the background and can upload images from your clipboard or filesystem to a host of your choice. The main README for the project is written in chinese which unfortunately I can't read. However, I was able to fumble my way through with some use of Google Translate and some guesswork. + +A bunch of services are supported out of the box or via plugins listed [here](https://github.com/PicGo/Awesome-PicGo) including Nextcloud, SFTP and S3 upload. + +### Motivation + +I find posting new content to my site a little bit of a pain. I have my own [micropub](https://indieweb.org/micropub) implementation and server which means I can quickly fire off the odd photo or note pretty easily, but when I'm writing a long form post, I find it quite irritating to have to manually do file management with images. PicGo + SFTP means that I can stop worrying about that and with the touch of a few keys, I can have images in my clipboard uploaded to my website and replaced with relevant markdown image embed code. + +### Installing + +Installation is a breeze for Linux users who are happy to work with [AppImage](https://appimage.org/) format. I imagine it's easy enough on Mac and Windows too. + +Firstly, I downloaded the latest AppImage for linux from the [release page](https://github.com/Molunerfinn/PicGo/releases/tag/v2.3.1). Then I ran it via the [AppImage Launcher](https://github.com/TheAssassin/AppImageLauncher). Hey presto, it started. + + +### Set the Language + +If you, like me, are unable to read chinese. You might want to change the language. + +The app opens in chinese on first run so you have to fumble your way around in the GUI to switch to English. First click on the tray icon and click on the first menu item to bring up the main window. The menu option with the cog next to it is the settings pane and then Language is the first option - the select/dropdown box. + +Restart the app so that the context menu reloads in English. + +### Setting up SFTP + +I run my website on a VPS which I normally upload stuff to via SFTP. I wanted to make it easy to paste images and have them uploaded to my website via SFTP and get a URL. + +#### Install the Plugin + +Open up the Plugins tab in the main dialog and search "sftp" - install the first plugin that appears: + +![a screenshot of the plugin page showing the sftp plugin](https://brainsteam.co.uk/media/2023/07/202307301510641.png) + + +#### Write a config file + +Next we write a JSON config file that we can use to tell the SFTP plugin how to log in to the server, where to store the files and how the path in SFTP maps on to the website path. + +I created mine in my home dir and called it `.picgo-sftp.json`: + +```json +{ + "mysite": { + "url": "https://mysite.com", + "path": "/media/{year}/{month}/{fullName}", + "uploadPath": "/var/www/mysite.com/media/{year}/{month}/{fullName}", + "host": "somehost.com", + "port": 22, + "username": "vpsuser", + "privateKey": "/home/user/.ssh/id_rsa", + "passphrase": "", + "fileUser": "vpsuser", + "dirMode": "0755" + }, +} +``` + +The config format is straight forward and pretty easy to understand. + + - **url** is the root url of your site (where your images will be visible from). + - **path** is the folder path that will be appended to the root url in order to generate your image url. + - **uploadPath** is the actual filesystem path inside SFTP where the image will be stored. This should reflect the URL path based on your web server config. + - In the above example, I have have nginx set to serve `/var/www/mysite.com/media/` when someone hits `https://mysite.com/media/`. + - In both `path` and `uploadPath We use special variables which get replaced with actual information at the time of upload: + - `{year}` - the current year i.e. 2023 + - `{month}` - the current month i.e. 07 + - `{fullName}` - the name of the image e.g. `mypicture.jpg` + - If I were to upload `mypicture.jpg` on the 1st of April 2023: + - the file would be written to `/var/www/mysite.com/media/2023/04/mypicture.jpg` + - the url returned by picgo to my clipboard would be `https://mysite.com/media/2023/04/mypicture.jpg` + +Once you save your config json, you'll need to go to Picbeds -> SFTP and enter the path to the json file in the 2nd box and the name of the site in the first box (this corresponds to the top level key in the json which is `mysite` in the example above. In theory you could have multiple sites configured). + +![a screenshot of the sftp plugin config](https://brainsteam.co.uk/media/2023/07/202307301521306.png) + +### Final Tweaks + +#### Filename Clashes + +I enabled a couple of options to make it easier to avoid name clashes on my server (i.e. uploading 2 files called image.png on the same day ends up overwriting the older one). + +![Settings pane showing rename before upload and timestamp rename options](https://brainsteam.co.uk/media/2023/07/202307301523755.png) + +- **Rename Before Upload** - PicGo seems to prompt me to enter a new filename at the time of upload whenever I upload anything +- **Timestamp Rename** - by default PicGo will replace the filename with the current timestamp down to seconds so I don't need to necessarily do anything to rename the file unless I want to give it a more descriptive name. + +#### Keyboard Shortcut + +For some reason the default keyboard combination for uploading from clipboard is set to `CTRL + SHIFT + P` which is the same as bringing up the command prompt in VSCode which I do *a lot*. I found the widget for remapping the key combination was a bit janky so I remapped this by going into the `Open Config File` setting and changing it manualy + +![A screenshot of the config file where I've manually changed the keyboard combo to CTRL + SHIFT + U](https://brainsteam.co.uk/media/2023/07/202307301530838.png) \ No newline at end of file