Tsubasa

Script for sharing screenshots and/or status updates using ihabunek/toot

Usage

Usage:
tsubasa [OPTION...] <command>

Help Options:
	-h,--help	Show help options
	-V,--version	Print version information and exit
	-v,--verbose	Print debug logging

Application Commands:
	nothing		(default) Saves a screenshot to the XDG Pictures directory and shares to Fediverse via toot
	window		Saves a screenshot of the current window to the XDG Pictures directory and shares to Fediverse via toot
	area		Saves a screenshot of a selected region to the XDG Pictures directory and shares to Fediverse via toot
	text		Share a status update to Fediverse via toot

Example

$ tsubasa --verbose window

Takes screenshot of a window and sends it to Fediverse via toot, while being verbose and printing debugging info.

Compatibility

Tested on Arch Linux using GNOME/Wayland, GNOME/X11, and Sway.
Tested on macOS 10.14 (Mojave). Should work on previous versions as well as Catalina and Big Sur. Make sure osascript and screencapture are in the $PATH.

Requirements

All platforms require ihabunek/toot for posting to Fediverse.
Linux requires the use of zenity for GUI dialog, and either gnome-screenshot for GNOME (X11/Wayland) or grimshot (grim/slurp) for Sway.
Linux can use notify-send for optional notifications.
macOS can use terminal-notifier for optional notifications.
macOS does not require a separate utility for screenshotting as the native screencapture is extremely powerful and intuitive. osascript is used to generate native dialogs via Apple Script to ask you for a message before posting.

Installation for Linux/BSD

Arch User Repository

$ yay -S tsubasa for tsubasa OR $ yay -S tsubasa-git for tsubasa-git

PKGBUILD for Arch Linux

$ makepkg -sic

Other (also for macOS)

It's just a shell script. Put it in your $PATH and you're good, or call it directly from where you store it.

Keyboard Shortcuts for macOS

I use gbammc/Thor for creating shortcuts to custom made “Apps” for each function of Tsubasa. These “apps” are available in tsubasa-mac.

Disclaimer for former users of ShareXin/ShareXin

I had originally planned on developing a successor to ShareXin, that was properly maintained and fully implemented in Rust.

But since then developing ShareXin, my interests have changed, and while I enjoy using Rust, I don't feel like maintaing an app I wasn't entirely sure how to fix in the first place.

I had originally made ShareXin as a simple Python script, putting together the Python Twitter API with PyQt5. I then turned it into a Rust app, that relied on external utilities for almost all of its functionality.

To me, it was nothing but a script pretending to be a compiled binary. It used sferik/t for Twitter, ihabunek/toot for Mastodon, and the only parts of ShareXin that used actual Rust were the Imgur API, and GTK, and those aren't much.

I won't be creating a successor to ShareXin, but rather creating a script for those who still want ShareXin functionality in an easier format. This behaves like ShareXin for all the reasons I made it for. If it is useful to you, go ahead and use it. If you'd like to extend it, go ahead and fork it.

The only improvements I will be making to this script will be to make it more portable and ensuring functionality on systems I use. But that's it. If you don't use GNOME/Sway/Aqua, I'm sorry. If you don't use Linux/BSD/macOS, I'm sorry. If you'd prefer Twitter or some other services to upload to, I'm sorry.

Alternatives

Francesco149/sharenix - It is a great Go app that has more in common with ShareX than ShareXin ever did. If you need custom API support, here you go!