subShare - ShareX linux alternative.
Features:
- Quickly upload and share files, text documents, screenshots and shorten links.
- Configurable to use your own Nextcloud instance for uploads.
- Uploading file contents to Hastebin.
- Shortening links via Polr. (selfhosted/public)
Examples:
Sharing a file:
https://s.atriox.io/vImLV # links are shortened via Polr :D
Sharing a text file:
https://s.atriox.io/noVEi
Skip down to usage for more example commands.
Summary:
I made Subshare since I couldn't find a suitable linux alternative for ShareX, which I used on Windows to capture my screenshots, share text and files after it would upload them to the respective servies. Eg: Nextcloud/Hastebin. So I made something to fit my needs. If there are issues feel free to open up a issue and I'll try to get it fixed. Better yet write some come and help a brotha out? :D
Installation:
Subshare is available on PyPi and can be installed with pip
https://pypi.org/project/subshare/
pip3 install --user subshare
Requirements
Linux: escrotum
- Scrot displayed artifacts when using selection mode. Escrotum fixed this.
Configuration
The default config file is created on the first run on subshare at ~/.subshare.yaml and concaints the following.
DefaultFileUploader: nextcloud
DefaultImageUploader: nextcloud
DefaultUrlShortener: polr
screenshots:
savedir: /home/user/screenshots/
quality: 100
nextcloud:
activated: true
url: https://cloud.yourwebsite.com
username: youruser
password: supersecretpassword
screenshot_directory: subshare/screenshots
uploads_directory: subshare/share
polr:
activated: true
url: https://polr.yourwebsite.com
apikey: 123127234982c34c2943c223c4
hastebin:
url: https://paste.yourwebsite.com
Enter all your respective details and a true or false for if you want to use Polr to shorten the links or not.
Usage
Note: All commands will automatically copy the link to your clipboard.
-
Sharing screenshots:
subshare screencaptures a regular screenshot.subshare screen selectlets you drag out a selection. -
Sharing text:
subshare text /path/to/filewill post the contents of the file to Hastebin. -
Sharing files:
subshare file /path/to/fileupload the file to your nextcloud instance. -
Shortening links:
subshare link "LINK TO SHORTEN"will shorten the link you specify. Dont forget the quotes around it.
To-do:
[x] Make Polr optional. [] Add alternative providers for uploading and sharing links... [] idk it pretty much does what I wanted rn. Feel free to make a pull request or open up an issue if you'd like anything added and we'll see what we can do.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.