{"id":47675393,"url":"https://github.com/pony-house/tiny-pony-clipper","last_synced_at":"2026-04-13T03:10:45.685Z","repository":{"id":346185825,"uuid":"1187730581","full_name":"Pony-House/Tiny-Pony-Clipper","owner":"Pony-House","description":"A background clipping tool optimized for Wayland and X11.","archived":false,"fork":false,"pushed_at":"2026-04-01T11:19:59.000Z","size":18418,"stargazers_count":1,"open_issues_count":6,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-03T01:37:39.112Z","etag":null,"topics":["clipping-tool","desktop-capture","electron","ffmpeg","gamepad-streaming","linux","linux-gaming","local-multiplayer-online","multiplayer","remote-play","replay-buffer","screen-recorder","wayland","webrtc"],"latest_commit_sha":null,"homepage":"https://remoteplay.pony.house/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Pony-House.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"patreon":"JasminDreasond","ko_fi":"JasminDreasond"}},"created_at":"2026-03-21T04:41:33.000Z","updated_at":"2026-04-01T11:20:03.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Pony-House/Tiny-Pony-Clipper","commit_stats":null,"previous_names":["jasmindreasond/tiny-pony-clipper","pony-house/tiny-pony-clipper"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/Pony-House/Tiny-Pony-Clipper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pony-House%2FTiny-Pony-Clipper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pony-House%2FTiny-Pony-Clipper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pony-House%2FTiny-Pony-Clipper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pony-House%2FTiny-Pony-Clipper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Pony-House","download_url":"https://codeload.github.com/Pony-House/Tiny-Pony-Clipper/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pony-House%2FTiny-Pony-Clipper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31492751,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-06T17:22:55.647Z","status":"ssl_error","status_checked_at":"2026-04-06T17:22:54.741Z","response_time":112,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["clipping-tool","desktop-capture","electron","ffmpeg","gamepad-streaming","linux","linux-gaming","local-multiplayer-online","multiplayer","remote-play","replay-buffer","screen-recorder","wayland","webrtc"],"created_at":"2026-04-02T13:28:26.441Z","updated_at":"2026-04-13T03:10:45.680Z","avatar_url":"https://github.com/Pony-House.png","language":"JavaScript","funding_links":["https://patreon.com/JasminDreasond","https://ko-fi.com/JasminDreasond","https://www.patreon.com/JasminDreasond","https://ko-fi.com/jasmindreasond"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n   \u003cimg src=\"./assets/logo.png\" height=\"300\" alt=\"logo\" /\u003e\n   \u003cbr/\u003e\n   \u003ca href=\"https://discord.gg/sSkysVtj7y\"\u003e\u003cimg src=\"https://img.shields.io/discord/881322783538298891?color=7289da\u0026logo=discord\u0026logoColor=white\" alt=\"Discord server\" /\u003e\u003c/a\u003e\n   \u003ca href=\"https://www.patreon.com/JasminDreasond\"\u003e\u003cimg src=\"https://img.shields.io/badge/donate-patreon-F96854.svg?logo=patreon\" alt=\"Patreon\" /\u003e\u003c/a\u003e\n   \u003ca href=\"https://ko-fi.com/jasmindreasond\"\u003e\u003cimg src=\"https://img.shields.io/badge/donate-ko%20fi-29ABE0.svg?logo=ko-fi\" alt=\"Ko-Fi\" /\u003e\u003c/a\u003e\n\n   [![Github](https://img.shields.io/badge/-Github-000?style=for-the-badge\u0026logo=Github\u0026logoColor=white)](https://github.com/Pony-Driland)\n   [![Twitter](https://img.shields.io/badge/-Twitter-1da1f2?style=for-the-badge\u0026logo=Twitter\u0026logoColor=white)](https://twitter.com/JasminDreasond/)\n   [![Wallet](https://img.shields.io/badge/-Wallet_Donation-ecf0f1?style=for-the-badge\u0026logo=Ethereum\u0026logoColor=black)](https://ud.me/jasmindreasond.x)\n   [![Bitcoin](https://img.shields.io/badge/-Bitcoin_Donation-0d579b?style=for-the-badge\u0026logo=Bitcoin\u0026logoColor=black)](https://www.blockchain.com/pt/btc/address/bc1qnk7upe44xrsll2tjhy5msg32zpnqxvyysyje2g)\n\u003c/div\u003e\n\n# Tiny Pony Clipper\n\nA lightweight, background clipping tool built with Electron and FFmpeg. Specifically optimized for Linux desktops (fully supporting both Wayland and X11), it constantly records a rolling buffer of your screen and saves the last few minutes instantly when a global shortcut is pressed.\n\n## 🌟 Features\n\n* **Wayland \u0026 X11 Support:** Uses native desktop portals for seamless screen capture on modern Linux environments.\n* **Advanced Audio Routing:** Native PulseAudio/PipeWire integration. Record system audio and microphone into a single track, or split them into entirely separate audio tracks.\n* **Smart Queue System:** Save multiple clips back-to-back. The background job dispatcher isolates the cache, allowing you to keep playing while FFmpeg processes the videos in parallel.\n* **Highly Customizable:** Tweak FFmpeg parameters (codecs, presets, and quality commands) directly from the UI.\n* **Remote Play Server (Experimental):** Turn your PC into a remote multiplayer hub! We have implemented a new WebRTC-based server that allows you to receive Gamepad inputs directly from a web browser.\n* **Up to 12 Players:** Bring everyone in! You can configure the server to accept up to 12 simultaneous remote gamepads.\n* **Bandwidth Saver (Video On/Off):** You can stream both your gameplay video and audio directly through the web client. However, if you prefer using other software for screen sharing (like Discord or OBS) to save bandwidth, you can disable the video stream entirely! The client page will elegantly adapt into a pure, ultra-low latency \"Gamepad Only\" dashboard.\n\n## 🛠️ Prerequisites\n\nTiny Pony Clipper relies on robust native Linux tools to handle audio and video processing. Ensure your system has the following packages installed:\n\n* `ffmpeg` (for video encoding and assembly)\n* `pulseaudio-utils` (provides `pactl` for audio device routing)\n* `libnotify-bin` (for native system notifications)\n\nOn Ubuntu/Kubuntu/Debian systems, you can install them via:\n\n```bash\nsudo apt update\nsudo apt install ffmpeg pulseaudio-utils libnotify-bin\n```\n\n### 🎮 Virtual Gamepad Support (uinput)\nTo use the **Remote Play Server**, the application needs permission to write to `/dev/uinput`.\n\n#### Win32\n\nEnsure your system has the following packages installed:\n\n* `ffmpeg` (for video encoding and assembly)\n* `ViGEmBus` (required if you want remote play features)\n\nOn your machine, you can install ffmpeg via:\n\n```bash\nchoco install ffmpeg\n```\n\n## 🚀 How to Use\n\n1.  **Launch the App:** Open Tiny Pony Clipper. It will quietly reside in your system tray.\n2.  **Configure Your Hardware:** Click the tray icon to open the Settings window. Select your Desktop Sound output and your Microphone.\n3.  **Set the Buffer:** Choose how many minutes of history you want to keep in the buffer.\n4.  **Save a Clip:** While playing a game or working, press the designated shortcut (default is `F10` on Wayland environments). A notification will confirm that your clip is being processed and saved to your chosen directory!\n\n*Note for Wayland users: Due to Wayland's strict security protocols regarding global keyloggers, the application internally locks the capture shortcut to `F10`. Ensure your desktop environment passes this key to the application.*\n\n## 📦 Installation (Pre-built)\n\nCheck the Releases page to download the latest files.\n\n## 💻 How to Build from Source\n\nTo successfully compile the native addons in this project, you need to ensure your environment has the necessary build tools and global packages installed.\n\nIf you want to contribute, modify the code, or compile it yourself, follow these steps:\n\n### 1- Clone the repository\n\n```bash\ngit clone https://github.com/Pony-House/Tiny-Pony-Clipper.git\ncd Tiny-Pony-Clipper\n```\n\n#### 1.1- System Prerequisites\n\nSince `node-gyp` compiles C++ code, your system must have a C++ compiler and Python installed.\n\n#### 1.2- Global Node.js Dependencies\n\nYou will need `node-gyp` to handle the native build configurations and `yarn` for package management:\n\n```bash\nnpm install -g node-gyp yarn\n```\n\n### 2- Install Node.js dependencies\n\n```bash\nyarn\n```\n\n### 3- Running the Build\n\nOnce the dependencies are met, you can trigger the configuration and compilation process:\n\n```bash\nyarn build:npx\n```\n\n### 4- Run in development mode\n\n```bash\nyarn start\n```\n\n### 5- Building the installers\n\nThe compiled binaries for both operating systems will be available in the `dist/` folder after the process is finished.\n\n#### 5.1- Linux (.deb, .AppImage, .tar.gz)\n\nTo generate the installers for Linux distributions, run:\n\n```bash\nyarn build:linux\n```\n\n#### 5.2- Windows (.exe) (BETA VERSION)\n\nFor Windows, the process requires an extra step to build the ViGEm client dependencies before packaging the final executable. Execute the following commands in order:\n\n```bash\n# First, build the ViGEm client\nyarn build:win:vigemclient\n\n# Then, build the Windows installer\nyarn build:win\n```\n\n## 💖 Contributing\n\nContributions, bug reports, and pull requests are always welcome! If this tool helps you capture your best moments, consider starring the repository or supporting the project to help keep the development active.\n\nTiny thanks for using Tiny Pony Clipper!\n\n---\n\n## 💡 Credits\n\n\u003e 🧠 **Note**: This documentation was written by [Gemini](https://gemini.google.com), an AI assistant developed by Google, based on the project structure and descriptions provided by the repository author.  \n\u003e If you find any inaccuracies or need improvements, feel free to contribute or open an issue!\n\n\u003cdiv align=\"center\"\u003e\n\u003ca href=\"https://github.com/Tiny-Essentials/Tiny-Essentials/tree/main/test/img\"\u003e\u003cimg src=\"./assets/5ec92aff-7a9d-4b86-bcc3-fe715def537a.png\" height=\"300\" alt=\"tiny-jasmini-js\" /\u003e\u003c/a\u003e\n\nMade with tiny love! 🍮\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpony-house%2Ftiny-pony-clipper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpony-house%2Ftiny-pony-clipper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpony-house%2Ftiny-pony-clipper/lists"}