Skip to content
Back to search

aphotic-hypr

Four identities. One desktop. Modular Plugins · Live Hot-Swapping · Seamless Customization · Resource-Aware (personal project)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday

Check it deeper on your machine

It has changed since its scan on 18 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/T-Crypt/aphotic-hypr with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/T-Crypt/aphotic-hypr'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/t-crypt--aphotic-hypr/badge.svg)](/listings/t-crypt--aphotic-hypr)

HTML

<a href="/listings/t-crypt--aphotic-hypr"><img src="/api/listings/t-crypt--aphotic-hypr/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Aphotic needs an Arch/AUR base. Plain Arch, [Omarchy](https://omarchy.org/) and EndeavourOS (Desktop Environment: None) are tested.

git clone https://github.com/T-Crypt/Aphotic-Hypr.git
cd Aphotic-Hypr
./install.sh

The installer makes the Aphotic greeter your login screen and keeps sddm installed as the way back. Pass `--keep-sddm` to stay on sddm. Omarchy keeps its own login.

Add `--dry-run` to see every change first; it runs before any `sudo` prompt or write. Update with `aphotic update`, remove with `./uninstall.sh`.

Every flag, profile and backup detail is in the [Installation guide](https://t-crypt.github.io/aphotic-hypr/docs/installation/).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 173 lines
  1. <p align="center">
  2. <img src="assets/aphotic-banner.svg" alt="Aphotic: Hyprland dotfiles, after dark" width="900">
  3. </p>
  4. <p align="center">
  5. <img src="https://img.shields.io/github/stars/T-Crypt/Aphotic-Hypr?style=for-the-badge&color=7DCFFF&labelColor=0b0d12">
  6. <img src="https://img.shields.io/github/issues/T-Crypt/Aphotic-Hypr?style=for-the-badge&color=E0AF68&labelColor=0b0d12">
  7. <img src="https://img.shields.io/github/forks/T-Crypt/Aphotic-Hypr?style=for-the-badge&color=F7768E&labelColor=0b0d12">
  8. <img alt="GitHub last commit" src="https://img.shields.io/github/last-commit/T-Crypt/Aphotic-Hypr?style=for-the-badge&color=AD8EE6&labelColor=0b0d12">
  9. <img alt="License" src="https://img.shields.io/github/license/T-Crypt/Aphotic-Hypr?style=for-the-badge&color=7DCFFF&labelColor=0b0d12">
  10. <img alt="Status: Beta" src="https://img.shields.io/badge/status-beta-E0AF68?style=for-the-badge&labelColor=0b0d12">
  11. </p>
  12. <p align="center">
  13. A modular Hyprland desktop built on one Quickshell shell.<br>
  14. Eight themes, a plugin platform, and a live map of what your GPU is doing.
  15. </p>
  16. <p align="center">
  17. <a href="#themes">Themes</a> ·
  18. <a href="#install">Install</a> ·
  19. <a href="#keybindings">Keybindings</a> ·
  20. <a href="https://t-crypt.github.io/aphotic-hypr">Documentation</a> ·
  21. <a href="https://github.com/T-Crypt/aphotic-plugins">Plugins</a>
  22. </p>
  23. <p align="center">
  24. <img src="./assets/preview.png" width="900">
  25. </p>
  26. ## What you get
  27. - **One shell for the whole desktop.** Bar, notch, launcher, notifications,
  28. lock screen, settings and Command Center, all in Quickshell. The
  29. screenshots use the Signal line skin: **Settings > Bar > Signal line**.
  30. - **Eight themes, switched live.** Or generate one from any wallpaper. No
  31. rebuild, no relogin.
  32. - **Plugins for everything extra.** AI chat, agent tracking, dev tools and
  33. desktop pets install and remove on a running desktop.
  34. - **A resource map that negotiates.** Flow shows which workloads fight over
  35. GPU memory and offers a fix. It never kills anything on its own.
  36. - **Profiles you opt into.** Developer, Gaming, AI and Security layers sit on
  37. a minimal or full base.
  38. ## Gallery
  39. <table>
  40. <tr>
  41. <td width="50%"><p align="center"><img src="./assets/screenshots/command-center.png" width="440"><br><sub>Command Center: clock, calendar, media, focus timer, weather</sub></p></td>
  42. <td width="50%"><p align="center"><img src="./assets/screenshots/flow.png" width="440"><br><sub>Flow: every workload and what it holds</sub></p></td>
  43. </tr>
  44. <tr>
  45. <td width="50%"><p align="center"><img src="./assets/screenshots/agents-popout.png" width="440"><br><sub>Agents: the running session and its usage limits</sub></p></td>
  46. <td width="50%"><p align="center"><img src="./assets/screenshots/processes-popout.png" width="440"><br><sub>Processes: the busiest processes by CPU, memory or GPU</sub></p></td>
  47. </tr>
  48. <tr>
  49. <td width="50%"><p align="center"><img src="./assets/screenshots/settings-appearance.png" width="440"><br><sub>Settings: themes and wallpapers</sub></p></td>
  50. <td width="50%"><p align="center"><img src="./assets/screenshots/settings-plugins.png" width="440"><br><sub>Settings: browse, install and toggle plugins</sub></p></td>
  51. </tr>
  52. <tr>
  53. <td width="50%"><p align="center"><img src="./assets/screenshots/wallpaper-carousel.png" width="440"><br><sub>Wallpaper picker, carousel layout</sub></p></td>
  54. <td width="50%"><p align="center"><img src="./assets/screenshots/wallpaper-grid.png" width="440"><br><sub>Wallpaper picker, grid layout</sub></p></td>
  55. </tr>
  56. </table>
  57. <p align="center">
  58. <img src="./assets/screenshots/workspace-plane.png" width="900"><br>
  59. <sub>Workspace plane: a full-screen surface a plugin can claim, here replaying an agent run step by step</sub>
  60. </p>
  61. ## Themes
  62. Eight themes ship with Aphotic, and `aphotic theme download` adds community ones. Switch with <kbd>Super</kbd> + <kbd>,</kbd> / <kbd>.</kbd>,
  63. or build your own from any wallpaper in **Settings > Theme Creator**.
  64. Each theme ships one wallpaper. The `wallpaper-packs` plugin adds theme-matched collections, downloaded with
  65. `aphotic wallpaper fetch` and checked against each file's hash. Updating keeps every wallpaper you already have.
  66. On a 21:9 screen, Aphotic picks ultrawide images first.
  67. <details>
  68. <summary><b>Every theme, same desktop</b></summary>
  69. <br>
  70. <table>
  71. <tr>
  72. <td width="50%"><p align="center"><img src="./assets/themes/tokyonight.jpg" width="440"><br><sub>Tokyo Night</sub></p></td>
  73. <td width="50%"><p align="center"><img src="./assets/themes/gruvbox.jpg" width="440"><br><sub>Gruvbox</sub></p></td>
  74. </tr>
  75. <tr>
  76. <td width="50%"><p align="center"><img src="./assets/themes/hackthebox.jpg" width="440"><br><sub>HackTheBox</sub></p></td>
  77. <td width="50%"><p align="center"><img src="./assets/themes/latte.jpg" width="440"><br><sub>Catppuccin Latte</sub></p></td>
  78. </tr>
  79. <tr>
  80. <td width="50%"><p align="center"><img src="./assets/themes/lofi.jpg" width="440"><br><sub>Lofi</sub></p></td>
  81. <td width="50%"><p align="center"><img src="./assets/themes/nordic.jpg" width="440"><br><sub>Nordic</sub></p></td>
  82. </tr>
  83. <tr>
  84. <td width="50%"><p align="center"><img src="./assets/themes/rosepine.jpg" width="440"><br><sub>Rosé Pine</sub></p></td>
  85. <td width="50%"><p align="center"><img src="./assets/themes/windows11.jpg" width="440"><br><sub>Windows 11</sub></p></td>
  86. </tr>
  87. <tr>
  88. <td width="50%"><p align="center"><img src="./assets/themes/dracula.jpg" width="440"><br><sub>Dracula (community)</sub></p></td>
  89. </tr>
  90. </table>
  91. </details>
  92. ## Install
  93. Aphotic needs an Arch/AUR base. Plain Arch, [Omarchy](https://omarchy.org/)
  94. and EndeavourOS (Desktop Environment: None) are tested.
  95. ```bash
  96. git clone https://github.com/T-Crypt/Aphotic-Hypr.git
  97. cd Aphotic-Hypr
  98. ./install.sh
  99. ```
  100. The installer makes the Aphotic greeter your login screen and keeps sddm
  101. installed as the way back. Pass `--keep-sddm` to stay on sddm. Omarchy keeps
  102. its own login.
  103. Add `--dry-run` to see every change first; it runs before any `sudo` prompt
  104. or write. Update with `aphotic update`, remove with `./uninstall.sh`.
  105. Every flag, profile and backup detail is in the
  106. [Installation guide](https://t-crypt.github.io/aphotic-hypr/docs/installation/).
  107. ## Keybindings
  108. | Keys | Action |
  109. | :-- | :-- |
  110. | <kbd>Super</kbd> + <kbd>A</kbd> / <kbd>Space</kbd> | Launcher (apps, clipboard, emoji, windows, wallpaper) |
  111. | <kbd>Super</kbd> + <kbd>D</kbd> | Command Center |
  112. | <kbd>Super</kbd> + <kbd>I</kbd> | Settings |
  113. | <kbd>Super</kbd> + <kbd>Shift</kbd> + <kbd>W</kbd> | Workspace plane, while a plugin provides one |
  114. | <kbd>Super</kbd> + <kbd>W</kbd> | Wallpaper picker |
  115. | <kbd>Super</kbd> + <kbd>L</kbd> | Lock screen |
  116. | <kbd>Super</kbd> + <kbd>Backspace</kbd> | Session menu |
  117. | <kbd>Super</kbd> + <kbd>,</kbd> / <kbd>.</kbd> | Cycle theme |
  118. | <kbd>Alt</kbd> + <kbd>Tab</kbd> | Window switcher |
  119. | <kbd>Super</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> | Screenshot picker |
  120. The rest live in [`Configs/hypr/keybinds.lua`](Configs/hypr/keybinds.lua) and on the
  121. [Keybindings page](https://t-crypt.github.io/aphotic-hypr/docs/keybindings/).
  122. ## Documentation
  123. **[t-crypt.github.io/aphotic-hypr](https://t-crypt.github.io/aphotic-hypr)**
  124. covers the rest: [Getting Started](https://t-crypt.github.io/aphotic-hypr/docs/getting-started/) ·
  125. [Profiles](https://t-crypt.github.io/aphotic-hypr/docs/profiles-and-layers/) ·
  126. [Plugins](https://t-crypt.github.io/aphotic-hypr/docs/plugin-system/) ·
  127. [CLI](https://t-crypt.github.io/aphotic-hypr/docs/cli-reference/) ·
  128. [FAQ](https://t-crypt.github.io/aphotic-hypr/docs/faq/) ·
  129. [Troubleshooting](https://t-crypt.github.io/aphotic-hypr/docs/troubleshooting/)
  130. Aphotic is in beta. Bug reports and hardware notes are welcome in
  131. [Issues](https://github.com/T-Crypt/Aphotic-Hypr/issues).
  132. ## Star History
  133. <a href="https://www.star-history.com/?type=date&repos=T-Crypt%2FAphotic-Hypr">
  134. <picture>
  135. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=T-Crypt/Aphotic-Hypr&type=date&theme=dark&legend=top-left&sealed_token=ypXqE7-DQiuJyvY9koFRVoIXk2HPugsrJGClSWh7P1FY8nA7ol-2RDfC5Y41CWpVnHmyqDL_mxAL6UDuAk2yrEhNhsBTCl-hTalGQg3Bp5cYQ1Zp1LGwDA94WqIIP4v30SrycPaZFcqA0L1LzsFi-PZF9vBE26aq4K5ihUzZzG9W0tfUNUlfL1p58oyW" />
  136. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=T-Crypt/Aphotic-Hypr&type=date&legend=top-left&sealed_token=ypXqE7-DQiuJyvY9koFRVoIXk2HPugsrJGClSWh7P1FY8nA7ol-2RDfC5Y41CWpVnHmyqDL_mxAL6UDuAk2yrEhNhsBTCl-hTalGQg3Bp5cYQ1Zp1LGwDA94WqIIP4v30SrycPaZFcqA0L1LzsFi-PZF9vBE26aq4K5ihUzZzG9W0tfUNUlfL1p58oyW" />
  137. <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=T-Crypt/Aphotic-Hypr&type=date&legend=top-left&sealed_token=ypXqE7-DQiuJyvY9koFRVoIXk2HPugsrJGClSWh7P1FY8nA7ol-2RDfC5Y41CWpVnHmyqDL_mxAL6UDuAk2yrEhNhsBTCl-hTalGQg3Bp5cYQ1Zp1LGwDA94WqIIP4v30SrycPaZFcqA0L1LzsFi-PZF9vBE26aq4K5ihUzZzG9W0tfUNUlfL1p58oyW" />
  138. </picture>
  139. </a>
  140. <br>
  141. ## License
  142. See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.