Merge 491b0fadee into 40e0d8c970

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.

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 <key>Alt</key> + <key>A</key> 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).

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)**