SMV Capture (Alpha)

Table of Contents

• Description
• Current capabilities
• Installation
• Usage
• Support
• Roadmap
• Contributing
• Authors and acknowledgment
• License
• Project status
• Maintainer notes
  • Useful links
  • Qt
  • Conventions
  • Some questions that could be answered

Description

Share My View (SMV) is being designed with the simple goal of making anything you can see on your desktop, sharable with anyone you choose. The target device form-factor are desktops computers (especially Linux), because screen-sharing is ubiquitos on mobile.

The goal is to have a very simple interface that doesn’t get in your way (or becomes cluttered), so that all you really have to do to share is to select a region of your screen, and start sharing. With that being said, the potential for misuse cannot be ignored, therefore secondary goal of SMV is to be as secure as possible so that potential misuse is easy to detect.

Although SMV is meant to be cross-platform (Windows, MacOs, Linux), I am primarily a Linux user, so the current focus is on the Linux side.

Current capabilities

Demo Screencast.webm

screencast.webm

See /docs/ for more images.

Installation

At the moment, no installation instructions are provided because we are still in very early stages

Usage

• You need xmake

• Run xmake b --rebuild capture

• Run xmake run capture

Support

Expect bugs. Report any glaring ones

Roadmap

• At the moment, it only supports taking screenshots of the desktop and saving it in png, or jpg. I plan to add one more useful image format: GIF.

• Integrate sharing via KDE-Connect or GSConnect

• Display list of recent captures

• Support for recording audio, and video

• Support for streaming audio and video

• Address many of the TODO’s in the code (there’s a lot)

Contributing

I’ve only been developing this for a month, so I don’t have any way of guiding anyone wishing to contribute. You can take a look at the TODO’s litered all over the code if you have a solution for some of them.

Authors and acknowledgment

License

CC BY-NC 4.0

Project status

Currently under heavy maintenance

---

Maintainer notes

The following are notes I’ve made for myself as I developed this app. I had no idea how XCB, QT, QML worked before starting. I had also never written a C++ application desktop application before, so these served as useful references for both learning and reminding myself. I also scattered a number of links throughout the code.

Useful links

• https://github.com/alaingalvan/CrossWindow

• https://xcb.freedesktop.org/XcbUtil/

• https://xcb.freedesktop.org/tutorial/

• https://xcb.freedesktop.org/manual/modules.html

• https://gist.github.com/penk/470486

• https://stackoverflow.com/questions/40533318/xcb-custom-message-to-event-loop

• https://github.com/Airblader/xedgewarp/blob/master/src/randr.c#L101

• https://github.com/TAAPArthur/XMouseControl/blob/master/xutil.c

• http://metan.ucw.cz/blog/things-i-wanted-to-know-about-libxcb.html

• https://cppget.org/spdlog?f=full#description

• https://unix.stackexchange.com/questions/503806/what-are-x-server-display-and-screen

• https://unix.stackexchange.com/questions/367732/what-are-display-and-screen-with-regard-to-0-0

• https://www.x.org/wiki/guide/

• https://www.x.org/releases/current/doc/

• https://www.x.org/releases/current/doc/xproto/x11protocol.html

Qt

• https://stackoverflow.com/a/52624533/2089675

• https://github.com/Luxoft/qml-coreui

• https://doc.qt.io/QMLLive/qmllive-installation.html

• https://github.com/carlonluca/lqtutils

Conventions

• https://manual.gromacs.org/documentation/2019/dev-manual/naming.html

Some questions that could be answered

• https://stackoverflow.com/questions/71131688/how-can-i-get-all-events-on-the-root-window-with-xcb

• https://stackoverflow.com/questions/37359063/x11-list-top-level-windows