{"id":25415494,"url":"https://github.com/thecodetherapy/urblind","last_synced_at":"2025-07-24T15:36:07.179Z","repository":{"id":276498975,"uuid":"929462414","full_name":"TheCodeTherapy/urblind","owner":"TheCodeTherapy","description":"A lightweight zooming tool for i3-wm on X11, built with Raylib.","archived":false,"fork":false,"pushed_at":"2025-02-11T16:06:11.000Z","size":2420,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-23T19:18:50.709Z","etag":null,"topics":["cpp","i3wm","linux","raylib","x11"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TheCodeTherapy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2025-02-08T15:55:25.000Z","updated_at":"2025-04-21T03:22:57.000Z","dependencies_parsed_at":"2025-02-08T17:19:17.164Z","dependency_job_id":"d7de94b9-3ef9-4d36-b2e7-83e88e6b02c4","html_url":"https://github.com/TheCodeTherapy/urblind","commit_stats":null,"previous_names":["thecodetherapy/urblind"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheCodeTherapy%2Furblind","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheCodeTherapy%2Furblind/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheCodeTherapy%2Furblind/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheCodeTherapy%2Furblind/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TheCodeTherapy","download_url":"https://codeload.github.com/TheCodeTherapy/urblind/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250496946,"owners_count":21440231,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["cpp","i3wm","linux","raylib","x11"],"created_at":"2025-02-16T15:35:38.299Z","updated_at":"2025-04-23T19:18:56.607Z","avatar_url":"https://github.com/TheCodeTherapy.png","language":"C++","readme":"# URBlind\n\n## A lightweight zooming tool for i3-wm on X11, built with Raylib.\n\nURBlind is a simple tool designed for i3-wm on X11, allowing you to zoom into portions of your desktop using the mouse wheel and pan with click-and-drag. I use it with a bind key to easily inspect details on my screen.\n\nI first saw a similar tool being used with i3 on X11 during a Twitch coding livestream by a guy named [Tsoding](https://www.twitch.tv/tsoding). I wasn't sure what software he was using, and I was too shy to ask, figuring that a hundred other people had probably already asked the very same question (which can be annoying). So, I decided to build my own.\n\n\u003cbr /\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/6ba7c70d-6371-4964-bcda-fc1dbc899f9d\"\u003e\n\u003c/div\u003e\n\n\u003cbr /\u003e\n\n---\n\n\u003cbr /\u003e\n\n### 🏗️ **Building the Project**\nMake sure to build the project first:\n\n```sh\n./build_posix.sh\n```\n\nAlternatively, while developing or changing the code, you may build and run with a single command like:\n\n```sh\n./build_posix.sh --run --debug 2 --debug-anchor tr\n```\n\n_(you'll find more details about the command line arguments below)_\n\n\u003cbr /\u003e\n\n### 💾 **Install**\n\nJust build the application and copy the built binary to any directory of your preference that is included in your system's `$PATH`. For your convenience, you can create a bind key to launch it on your `i3-wm config` (or any other way you use to create system-wide bind keys).\n\nThe built binary will be at `./build/urblind`.\n\n\u003cbr /\u003e\n\n### 🚀 **Running the Application**\n\n```sh\nurblind [monitor_index] [OPTIONS]\n```\n- If no monitor index is provided, the **rightmost monitor** will be used by default.\n\n\u003cbr /\u003e\n\n### 🛠 **Options**\n| Argument                      | Description |\n|-------------------------------|-------------|\n| `--help`                      | Show help message and exit. |\n| `--debug`                     | Enable debug panel to display real-time info. |\n| `--debug-anchor {tl\\|tr\\|bl\\|br}` | Set debug panel anchor position. Options: `tl` (top-left, default), `tr` (top-right), `bl` (bottom-left), `br` (bottom-right). |\n\n\u003cbr /\u003e\n\n### 📌 **Usage Examples**\n\n#### Start using the **default (rightmost) monitor**:\n```sh\nurblind\n```\n\n#### Select **monitor index 2**:\n```sh\nurblind 2\n```\n\n#### Check your **monitor indexes** to select the right one:\n```sh\nurblind --help\n```\n\n\n#### Run on **monitor index 1** and Enable debug panel:\n```sh\nurblind 1 --debug\n```\n\n#### Run on **monitor index 1** and Enable debug panel with **bottom-right anchor**:\n```sh\nurblind 1 --debug --debug-anchor br\n```\n\n#### Run on **monitor index 3** with debug panel **top-right anchored**:\n```sh\nurblind --debug-anchor tr --debug 3\n```\n\n\u003cbr /\u003e\n\n---\n\n\u003cbr /\u003e\n\n### Q\u0026A:\n\n- _Can I use this on Gnome?_\n\n  Yes, you can use it with Gnome. I listed this as an i3-wm tool because that's the environment I use it with, and I assumed desktop environments like Gnome already count with a similar tool out of the box.\n\n- _Can I use this on KDE?_\n\n  Probably, as long as you're using X11. I haven't tested, though.\n\n- _Can I use this on Wayland?_\n\n  No. I'm using `\u003cX11/Xlib.h\u003e` and `\u003cX11/Xutil.h\u003e` to capture the contents of the desktop. Also, I have no interest in Wayland as I don't appreciate giving up control over my system under the argument of security (the usual _\"it's for your own safety\"_ bullshit). It is a design decision in Wayland not to expose absolute window positions to clients nor to allow setting the absolute position of a window. I can't overstate enough how much I don't care for Wayland.\n\n- _Can I suggest improvements or raise a PR?_\n\n  Sure!\n\n- _Can I raise a PR to make this compatible with Windows or MacOS?_\n\n  Please feel free to fork and adapt it to your operating system. Raylib allows you to do that easily. However, for this repo, I prefer keeping it simple rather than overcomplicating it to make it compatible with other operating systems, so I won't merge any code to do that.\n\n- _Can I use a different monospaced custom font for the Debug Panel?_\n\n  Yes. Just convert any TrueType font you may want to use with `xxd`, add the generated header file to the include directory, and include your new font on `main.cpp`.\n\n  To convert your font, use:\n\n  ```bash\n  xxd -i your_cool_font.ttf \u003e ./include/your_cool_font.hpp\n  ```\n\n  Please keep in mind to inspect the file to find the names for the `unsigned char \u003cname_here\u003e_ttf[]` and the `unsigned int \u003cname_here\u003e_ttf_len` that you'll need to use to load the font with Raylib. See `main.cpp` for a usage reference.\n\n\u003cbr /\u003e\n\n---\n\n\u003cbr /\u003e\n\n### Enjoy my work?\n\nGive it a ⭐ and get in touch (and/or Tweet me memes) on X at **[@TheCodeTherapy](https://x.com/TheCodeTherapy)** 🤓\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthecodetherapy%2Furblind","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthecodetherapy%2Furblind","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthecodetherapy%2Furblind/lists"}