diff --git a/content/Useful Utilities/Phone-connect.md b/content/Useful Utilities/Phone-connect.md new file mode 100644 index 00000000..25fa71e2 --- /dev/null +++ b/content/Useful Utilities/Phone-connect.md @@ -0,0 +1,65 @@ +--- +weight: 7 +title: Phone connect +--- + +This page lists utilities for connecting phones to a Hyprland session, including +device integration, file access, screen mirroring, and quick local file sharing. + +## Phone integration + +### KDE Connect + +[KDE Connect](https://kdeconnect.kde.org/) integrates phones with the desktop. +It can share files and clipboard contents, show phone notifications, ring or +find a device, and expose remote input features. + +Install [hypr-kdeconnect-fix](https://github.com/gfhdhytghd/hypr-kdeconnect-fix) to make the remote input funtion of kde connect work. + +## Device access + +### Android: adb and MTP + +Install `android-tools` for `adb`. Enable USB debugging on the phone, then check +that the device is visible: + +For file-manager access over MTP, install `gvfs-mtp`. This lets GVfs-aware file +managers browse Android storage after the phone is unlocked and set to file +transfer mode. + +### iOS: libimobiledevice and ifuse + +Install [`libimobiledevice`](https://libimobiledevice.org/) and +[`ifuse`](https://github.com/libimobiledevice/ifuse) for iPhone and iPad access. + +Package names and service handling vary by distro. Some setups also need +`usbmuxd` running for iOS devices. + +## Screen mirroring + +### scrcpy + +[`scrcpy`](https://github.com/Genymobile/scrcpy) displays and controls Android +devices over USB or TCP/IP using `adb`. It is lightweight and works well when +USB debugging is enabled. + +### Escrcpy + +[Escrcpy](https://github.com/viarotel-org/escrcpy) is a graphical frontend built +around `scrcpy`. It can be useful if you prefer managing multiple Android +devices, mirroring options, and common actions from a GUI instead of command-line +flags. + +## Quick local file sharing + +### LocalSend + +[LocalSend](https://localsend.org/) is a cross-platform local-network file +sharing application. Install it on both devices, keep them on the same network, +and send files without setting up SSH, SMB, or cloud storage. + +### Fyde Drop + +[Fyde Drop](https://drop.fydeos.io/) is a browser-based local-network file sharing +tool. Open the page on both devices and use it for quick one-off transfers when +you do not want to install an application. diff --git a/content/Useful Utilities/Screenshots-and-Recording.md b/content/Useful Utilities/Screenshots-and-Recording.md new file mode 100644 index 00000000..92ce77ff --- /dev/null +++ b/content/Useful Utilities/Screenshots-and-Recording.md @@ -0,0 +1,98 @@ +--- +weight: 5 +title: Screenshots & Recording +--- + +This page lists commonly used tools for taking screenshots and recording the +screen on Hyprland. + +## Screenshot utilities + +### HyprCapture + +[HyprCapture](https://github.com/gfhdhytghd/HyprCapture) is a Hyprland-oriented +screenshot and recording utility. It is useful if you want a workflow that is +integrated with Hyprland instead of wiring several smaller tools together. + +### grim and swappy + +[`grim`](https://sr.ht/~emersion/grim/) is a simple Wayland screenshot tool. It +is commonly used with [`slurp`](https://github.com/emersion/slurp) for area +selection and [`swappy`](https://github.com/jtheoof/swappy) for annotations. + +For example, to select an area and open it in `swappy`: + +```ini +bind = , Print, exec, grim -g "$(slurp)" - | swappy -f - +``` + +To copy a selected area directly to the clipboard, install +[`wl-clipboard`](https://github.com/bugaevc/wl-clipboard) and use: + +```ini +bind = SUPER, Print, exec, grim -g "$(slurp -d)" - | wl-copy +``` + +### Flameshot + +[Flameshot](https://github.com/flameshot-org/flameshot) is a screenshot tool +with a built-in annotation UI. On Wayland, it relies on portal support for screen +capture. If it cannot capture the screen, make sure your desktop portal setup is +working or use `grim` with `swappy` instead. + +### WeChat screenshot + +WeChat has its own screenshot shortcut. If Hyprland catches the keybind first, +WeChat will not receive it unless the keybind is explicitly passed to the WeChat +window. + +Use the `pass` dispatcher to forward Alt + A to WeChat: + +```ini +bind = ALT, A, pass, class:^(wechat)$ +``` + +The `pass` dispatcher sends both the press and release events to the matched +window, so a separate `bindr` is not needed. This is useful for application +shortcuts that need to behave like global shortcuts while still being handled by +the application itself. + +If the bind does not work, check the actual WeChat window class: + +```sh +hyprctl clients +``` + +Then adjust the matcher accordingly. For example, if your package reports a +different class, replace `class:^(wechat)$` with the class shown by +`hyprctl clients`. + +## Recording utilities + +### OBS Studio + +[OBS Studio](https://obsproject.com/) can record the screen through PipeWire and +the desktop portal. Make sure `pipewire`, `wireplumber`, +[`xdg-desktop-portal-hyprland`](../../Hypr-Ecosystem/xdg-desktop-portal-hyprland) +and `qt6-wayland` are installed. See [Screen sharing](../Screen-Sharing) for +portal setup notes. + +### wf-recorder + +[`wf-recorder`](https://github.com/ammen99/wf-recorder) is a lightweight +Wayland screen recorder. + +Record the whole screen: + +```sh +wf-recorder -f ~/Videos/recording.mp4 +``` + +Record a selected region: + +```sh +wf-recorder -g "$(slurp)" -f ~/Videos/recording.mp4 +``` + +If capture tools are blocked by Hyprland's permission system, see +[Permissions](../../Configuring/Advanced-and-Cool/Permissions). diff --git a/content/Useful Utilities/_index.md b/content/Useful Utilities/_index.md index d117b465..a9657510 100644 --- a/content/Useful Utilities/_index.md +++ b/content/Useful Utilities/_index.md @@ -20,8 +20,12 @@ Hyprland working. - **[Screen Sharing](./Screen-Sharing)** +- **[Screenshots & Recording](./Screenshots-and-Recording)** + - **[App Clients](./App-Clients)** +- **[Phone connect](./Phone-connect)** + - **[Color Pickers](./Color-Pickers)** - **[Clipboard Managers](./Clipboard-Managers)**