This is a fork from https://github.com/evadogstar/qvm-screenshot-tool, that was updated here (credits to tzwcfq). Also I've added dynamic szie
The qvm-screenshot-tool is a screenshot tool for Qubes OS
This tool provide funcionality to make screenshots at Qubes dom0, edit them and upload it automaticaly to AppVM, to imgurl service thought this AppVm and some other taks.
This tool must be places and used only at dom0
No need to upload something to TemplateVM.
Need example? All screenshots on this tutorial done by this tool :)
0.9 - version fro Qubes R4.1 based on deepin-screenshot provide new more easy way to draw, anotate on screenshots. No more scrot (it's not supported by new dom0 fedora 32)
0.8 beta - Dom0 full log with all screenshot uploads. Possible to erase this log. Bug fix, before that all screenshots were stored at dom0 by default (thanks @heinrich-ulbricht). Now they removed by default.
0.7 beta - Now Qubes Screenshot Tool support command line arguments. You can setup some keybinding to skip all dailogs and quickly do the same job. e.g. qvm-screenshot-tool.sh --region-only --imgurl --virtualmachine APPNAME
0.6 - Now possible to skip first dialog and make choice from command line: --region-only
or --fullscreen
0.5 beta - added option to reopen closed dialog (imgurl upload dialog) again at AppVM. "Kshaphoot" removed if it's not installeted at the Qubes system.
0.4 beta - fixed some minor issues with user "pictures" dir name on dom0. (multilingual)
0.3 beta - fixed some minor issues with user "pictures" dir name on destination VM. (multilingual)
0.2 beta - Now the tool support editing images at dom0. You can aanotane any text to screenshot, crop image, composite, draw the lines and use filters! Read how to do that below.
Don't know
You will be asked for actions by GUI prompt.qvm-screenshot-tool
support ksnapshot
(KDE5 tool) and now at 0.9+ version deepin-screenshot
console tool to make screenshots which is not available by default at dom0, but it can by simple installed to it with one command sudo qubes-dom0-update deepin-screenshot zenity
Qubes Team plan to remove KDE5
from Qubes by default, therefore ksnapshot
will be also removed. Accordingly, I highly recommend to use it with deepin-screenshot
.
- You can start
ksnapshot
first and make your screenshot with it, then startqvm-screenshot-tool
or you can startqvm-screenshot-tool
and selectksnapshot
option at dialog window. - After
qvm-screenshot-tool
started. It will popup confirmation dialog. Do not close it, if you are NOT ready to do something with your screenshot atksnapshot
! Make screenshot first. - If you are happy with result at
ksnapshot
preview window. Then clickyes
onqvm-screenshot-tool
dialog. - New dialog will be apiared and then you can choose options to upload screenshot etc. (read more below)
All other options on first dialog use scrot
tool to make screenshots.
- Start tool with
./qvm-screenshot-tool
or hotkey which you already setup (see install section) - Choose e.g.
region or window
- Simple click on window to make screeshot of that window. Drag mouse with left button down to select region of the screen.
- Then select actions what you want to do with screenshot. e.g. upload it to imgurl server, only it to AppVM or dom0
- You will be prompted. Select destination AppVM. Throught this VM utility will upload screenshot to imgurl server.
- Then amazing dialog apear at AppVM window. You will find urls on it. Simple select them with the mouse and
Ctrl+C
them to put to clipboard. - If
nautilus
mode was selected it will be started with$PATH
opened. Ifxcopy
is installeted. Url will be copy to clickboard.
How to use the ImageMagick editon (no longer need from 0.9 version, now deepin-screenshot can annotate and draw on yor images at first stage)
You can edit scrrenshot before upload it to img url or move them to AppVM.
- Select edit mode (and upload move if need to also upload)
- You will see image on the screen. Click on it to get menu.
- Edit the image. if you do something wrong clock "Ctrl-Z" to undo changes.
- When you are ready to upload. Go to File -> Save and choose predefined possition
0000-SAVE-EDITED-SHOT-HERE-TO-PROCESS.png
to save it to (or we will continue with not edited screenshot) - Just Quit from the editor and tool will continue to move screenshot to AppVM or uploading.
Exit
-- screenshot already stored at ~/Pictures on dom0
. If this opion selected tool immediately exit and nothing more
Upload tp AppVM only
-- tool will upload the image to selected destination AppVM. You can also select to open it with Nautilus
and remove image from dom0
Upload to Imgurl
- will do this magic for you, if options above not selected.
Start Nautilus at AppVM
-- will start nautilus
with opened directory where the image stored
Keep screenshot at dom0
-- will keep the image at dom0. By default its removed (expect Exit
goal)
- Make screenshots with ksnapshot or deepin-screenshot
- Draw, annotate, select area on screenshot
- Upload screenshots to AppVM
- Auto-Start VM if it's not running
- Upload screenshots to imgurl server and provide urls
- Copy link to AppVM clipboard
- Last upload log with imgurl link and deletion link is stored at AppVM: ~/Pictures/imgurl.log
- Automatic image deletion from dom0 (you can switch it off on dialog)
- Urls notifications are where from you can copy urls to clipboard
- NEW! Support command line argumens to skip dialogs and quikly to the same job.
First, you must review the code, before upload it to dom0 ! Always do that if you are uploading code to dom0 from some other source and other way then Qubes Team recommend it !!!
Discussion thread on the qubes maillist about the code:
https://forum.qubes-os.org/t/r4-1-qubes-screenshot-tool/7005
https://groups.google.com/forum/#!topic/qubes-users/dcsRRPf0Fxk
First install dependencies:
sudo qubes-dom0-update zenity deepin-screenshot
Then just save qvm-screenshot-tool.sh
as a file to any AppVM. Then copy it to dom0
with the following command at dom0 terminal:
qvm-run --pass-io NAMEOFAPPVM 'cat /path/to/qvm-screenshot-tool.sh' > /home/user/Pictures/qvm-screenshot-tool.sh
Then give it execute privilegies at dom0 terminal:
chmod +x /home/user/Pictures/qvm-screenshot-tool.sh
Of course, you can start it for testing purposes from command line:
./qvm-screenshot-tool.sh
It's possible to skip first dialog and make choice from command like with --region-only
or --fullscreen
:
./qvm-screenshot-tool.sh --region-only
./qvm-screenshot-tool.sh --fullscreen
Now, you are ready to setup it on some hotkey combination. Go to System -> Keyboard settings
and bind the script to your favorite shortcut PrintScreen
key or to e.g. Ctrl+PrintScreen
combination.
Most are probably pre-installed at Qubes OS
by default.
sudo qubes-dom0-update zenity deepin-screenshot
- zenity
- deepin-screenshot
- Linux only AppVMs supported
- curl at Linux AppVM
- zenity at dom0 and at AppVM.
- scrot at dom0 (recommended) or ksnapshot
- ImageMagick (already at dom0 preinstalleted)
- xclip at AppVM (only need if you want also copy url to clipboard automaticaly att AppVM)
Qubes OS only. :-)
This will not fully work on Windows AppVMs. Only if Qubes Team will add something like cygwin. But are you really want Windwos support for uploading images to imgurl service?
Also its is almost ready for GNOME !!!
- Report issues
- Submit feature request
- Make a pull request
- If you like this tool, you can donate Qubes OS developers https://www.qubes-os.org/donate/#bitcoin and maybe send me notification at
qubes-users
maillist that you are happy with this tool and you do that, because of it :) - check privacy tools list for amazing privacy list