Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/merlin04/vgy.me
A CLI for the image hosting website vgy.me
https://github.com/merlin04/vgy.me
api-client cli cli-app cli-application csharp dotnet image-hosting upload-images uploader
Last synced: about 4 hours ago
JSON representation
A CLI for the image hosting website vgy.me
- Host: GitHub
- URL: https://github.com/merlin04/vgy.me
- Owner: Merlin04
- License: gpl-3.0
- Created: 2020-07-27T02:24:23.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2022-12-08T11:03:28.000Z (almost 2 years ago)
- Last Synced: 2023-03-01T04:15:59.530Z (over 1 year ago)
- Topics: api-client, cli, cli-app, cli-application, csharp, dotnet, image-hosting, upload-images, uploader
- Language: C#
- Homepage:
- Size: 28.3 KB
- Stars: 3
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# vgy.me
A CLI for the image hosting website vgy.me. To use this, you'll need a vgy.me userkey, which you can generate [here](https://vgy.me/account/details).
## Installation
Use the dotnet command line tool to install:
```
dotnet tool install -g vgy.me
```
## Usage
### Upload
Upload an image:
```
$ vgy.me upload file1.png
URL: https://vgy.me/u/demo
Image URL: https://i.vgy.me/demo.png
Delete: https://vgy.me/delete/democode
```
Upload an image with a title and description:
```
$ vgy.me upload file2.png -t "Title" -d "Description"
```
Upload multiple images to an album:
```
$ vgy.me upload file1.png file2.png file3.png
Album URL: https://vgy.me/album/demo
Images:
- https://i.vgy.me/demo1.png
- https://i.vgy.me/demo2.png
- https://i.vgy.me/demo3.png
```
### Delete
Delete an image using the delete URL:
```
$ vgy.me delete https://vgy.me/delete/democode
```
Delete an image using the viewer URL or image URL:
```
$ vgy.me delete https://vgy.me/u/demo
```
Delete all images uploaded since the app was installed (does not include images uploaded as part of an album):
```
$ vgy.me delete all
```
### Configure
Set userkey:
```
vgy.me configure "insert-userkey-here"
```
Remove configuration file:
```
vgy.me configure reset
```
## How it works
This tool is written in C#/.NET Core and uses the CliFx framework, which provides all of the behavior of command line apps you're used to like help screens and arguments. It also provides a way to implement dependency injection, which allows all of the commands to get access to an `HttpClient` and the configuration data, which is stored in `~/.vgy.me.json` and is loaded when the app is run. Uploading images uses the vgy.me API, and deleting them uses `ScrapySharp` to access the delete page and click the delete button. The tool keeps track of the files you upload in the configuration file and can use that data to look up the delete URL for an image URL. Unfortunately, the vgy.me API does not provide a delete URL for albums so the tool can't keep track of those, you have to delete them from the web interface.