{"id":43083409,"url":"https://github.com/benjikuo/desktop-screen-pen","last_synced_at":"2026-05-11T10:03:44.649Z","repository":{"id":324473718,"uuid":"1097352893","full_name":"Benjikuo/Desktop-screen-pen","owner":"Benjikuo","description":"A tool that allows users to draw anywhere on the screen.","archived":false,"fork":false,"pushed_at":"2026-02-26T08:25:50.000Z","size":19491,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-26T15:40:21.719Z","etag":null,"topics":["desktop","draw","pen","screen"],"latest_commit_sha":null,"homepage":"","language":"Python","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/Benjikuo.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-16T02:17:52.000Z","updated_at":"2026-02-26T02:47:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Benjikuo/Desktop-screen-pen","commit_stats":null,"previous_names":["benjikuo/desktop-screen-pen","benjikuo/desktop-screen-pen___x.unfinished"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/Benjikuo/Desktop-screen-pen","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Benjikuo%2FDesktop-screen-pen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Benjikuo%2FDesktop-screen-pen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Benjikuo%2FDesktop-screen-pen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Benjikuo%2FDesktop-screen-pen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Benjikuo","download_url":"https://codeload.github.com/Benjikuo/Desktop-screen-pen/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Benjikuo%2FDesktop-screen-pen/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32889972,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-10T13:40:02.631Z","status":"online","status_checked_at":"2026-05-11T02:00:05.975Z","response_time":120,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["desktop","draw","pen","screen"],"created_at":"2026-01-31T15:04:41.107Z","updated_at":"2026-05-11T10:03:44.637Z","avatar_url":"https://github.com/Benjikuo.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Desktop-screen-pen\n\n![License](https://img.shields.io/badge/License-MIT-yellow)\n![Language](https://img.shields.io/badge/Language-Python-blue)\n\nA tool that allows users to draw anywhere on the screen.\n\n\u003cp\u003e\n  \u003cimg src=\"./image/showcase/showcase.gif\" width=\"850\"\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\n## 🛠️ Why I Built This\n- I often need to jot down notes, highlight ideas, or illustrate concepts directly on my desktop.\n- Being able to turn my computer into a simple **“blackboard”** whenever I need it is super handy.\n- I’m also using this project as a chance to get better at building desktop apps with **PySide2 / Qt**.\n\n\u003cbr\u003e\n\n## 🧩 Features\n- ✏️ **Free Drawing** – Draw anywhere on your screen with smooth strokes\n- \u0026nbsp;█\u0026nbsp; **Eraser Tools** – Normal eraser + rectangular crop eraser\n- 🎨 **Brush Controls** – Change size, shape, and 7 colors instantly\n- ↩️ **Undo / Redo** – Full history tracking for every stroke\n- 🖼️ **Screenshot Export** – Save with black or transparent background\n- 🧰 **Floating Toolbar** – Quick access to all tools in one place\n\n\u003cbr\u003e\n\n## 📂 Project Structure  \n```\nDesktop pen/\n│── image/\n│   ├── toolbar/       # toolbar icon\n│   └── showcase/      # Demonstration gif\n│── main.py\n│── window.py\n│── toolbar.py\n│── controller.py\n│── canva.py\n├── LICENSE            # MIT license\n└── README.md          # Project documentation\n```\n\n\u003cbr\u003e\n\n## 🔗 Dependencies\nThis project uses **PySide2 (Qt5 bindings for Python)** for the GUI and **mss** for screen capture.\n\n\u003cbr\u003e\n\n## ⚙️ Requirements\nInstall dependencies before running:\n```bash\npip install PySide2 mss\n```\n\n\u003cbr\u003e\n\n\n## ▶️ How to Run\n1. Clone \u0026 run:\n```bash\ngit clone https://github.com/Benjikuo/Desktop-screen-pen.git\npython main.py\n```\n2. Draw on the screen with a floating toolbar at the top for all drawing controls.\n\n\u003cbr\u003e\n\n## 💻 Keyboard and Mouse Controls\n### [Keyboard]\n**Mode Toggles:**\n| Key | Action | Mode |\n|-----|--------|-------------|\n| `1`       | Toggle the **board**       | transparent / black |\n| `2` , `Z` | Toggle the **tool**        | pen / highlight / eraser / crop eraser |\n| `3`       | Toggle the **stroke size** | 4px / 6px / 10px / 14px / 20px / 30px / 50px |\n| `4` , `X` | Toggle the **shape**       | free pen / line / rectangle |\n| `5` , `C` | Toggle the **color**       | ⬜white / 🟥red / 🟧orange / 🟨yellow / 🟩green / 🟦blue / 🟪purple |\n\n*(**+Shift**: toggles in the opposite direction)*\n\n\u003cbr\u003e\n\n**Direct Actions:**\n| Key | Action | Description |\n|-----|--------|-------------|\n| `6` , `S` or `Ctrl + S`         | Save  | Save with current background |\n| `7` , `D` or `Ctrl + Z`         | Undo  | Undo the last change |\n| `8` , `F` or `Ctrl + Y`         | Redo  | Redo the last change |\n| `9` , `A` or `Ctrl + X`         | Clear | Clear all strokes |\n| `0` , `Q` , `Ctrl + R` or `Esc` | Quit  | Quit the program |\n\n\u003cbr\u003e\n\n**✨ Quick Mode Toggles:**\n| Key | Action | Description |\n|-----|--------|-------------| \n| `W` | Toggle mode   | Cycle through **transparent / black / view mode** |\n| `E` | Toggle eraser | Press again to switch to **crop-eraser** |\n| `R` | Toggle pen    | Press again to switch to **highlighter** |\n\n*(**+Shift**: toggles in the opposite direction)*\n\n\u003cbr\u003e\n\n**✏️ Tool Shortcuts:**\n| Key | Tool |\n|-----|------|\n| `Space` | ⚪ White pen |\n| `T`     | 🔴 Red pen |\n| `Y`     | 🟠 Orange pen |\n| `G`     | 🟡 Yellow pen |\n| `H`     | 🟢 Green pen |\n| `B`     | 🔵 Blue pen |\n| `N`     | 🟣 Purple pen |\n| `V`     | 🟥 Red square outline tool |\n\n---\n\n### [Mouse]\n| button \\ item | Canva | Toolbar | Button |\n|---------------|-------|---------|--------|\n| left click   | Draw              | Set **drawing** mode | Select the tools  |\n| middle click | Close the program | Close the program    | Close the program |\n| right click  | Set **view** mode | Set **view** mode    | Set **view** mode |\n\nThe **mouse wheel** up and down can control the **brush size**.\n\n\u003cbr\u003e\n\n## 📜 License\nReleased under the **MIT License**.  \nYou are free to use, modify, and share it for learning or personal projects.\n\n**Draw anything you can imagine!**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenjikuo%2Fdesktop-screen-pen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbenjikuo%2Fdesktop-screen-pen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenjikuo%2Fdesktop-screen-pen/lists"}