hgfloater is a lightweight, high-performance utility designed for Windows 11 and above. It leverages translucent floating boxes and optimized keyboard/mouse interactions to enable fast and responsive computer operation. Built using pure C and WinAPI, it operates with zero external dependencies, ensuring an extremely fluid user experience.

1. Download: Get the latest hgfloater.exe from the Releases page.
2. Execute: Just run hgfloater.exe.
3. Shortcuts: To add your own shortcuts to the taskbox, place .lnk or .url files in %USERPROFILE%\.HellGates\hgfloater\shortcuts.
4. Hotkey: Press Win + Alt + Space (Default) to summon the taskbox.

1. 다운로드: Releases 페이지에서 최신 hgfloater.exe 파일을 다운로드하세요.
2. 실행: 다운로드한 hgfloater.exe를 실행하기만 하면 됩니다.
3. 단축 아이콘 추가: 나만의 단축 아이콘을 태스크 박스에 추가하려면 %USERPROFILE%\.HellGates\hgfloater\shortcuts 폴더에 바로가기(.lnk)나 웹 링크(.url) 파일을 넣으세요.
4. 단축키: Win + Alt + Space (기본값)를 눌러 태스크 박스(taskbox)를 불러낼 수 있습니다.

• English Version
• 한국어 버전

The primary goal of hgfloater is to provide a streamlined, highly customizable environment for efficient system control. Currently, it functions as a Quick Launcher (via shortcuts) and a Task Switcher, allowing users to position control interfaces anywhere on the screen and manipulate them instantly.

While it complements the default Windows Taskbar, hgfloater is built for power users who demand maximum speed. The current version is just the beginning; future updates will introduce a wider array of features dedicated to making computer operation even more intuitive and responsive.

hgfloater stores its data in the user's profile directory to ensure persistence without interfering with system files.

• Base Directory: %USERPROFILE%\.HellGates\hgfloater
  • This is the root folder where all application data is stored.
• Shortcuts Directory: %USERPROFILE%\.HellGates\hgfloater\shortcuts
  • Place your application shortcuts (.lnk) or web links (.url) here. They will automatically appear in the taskbox toolbar.
• Configuration File: %USERPROFILE%\.HellGates\hgfloater\config.ini
  • Stores all user preferences, window positions, and hotkey settings.

The configuration file uses a standard INI format. You can manually edit these values while the program is closed.

• font_name: The name of the font to be used universally across the editing controls, tooltips, and the about dialog (Default is Segoe UI).

• x, y: The screen coordinates (top-left) of the window.
• w, h: The width and height of the window.
• alpha: The opacity level of the window (128-255).
• font_size: The size of the text font.
• icon_size: (Only in [taskbox]) The bounds resolution of the icons.

• global_focus_modifiers: Bitmask for modifier keys (e.g., Alt=1, Ctrl=2, Shift=4, Win=8). Default is 9 (Win + Alt).
• global_focus_key: The virtual key code for the trigger key. Default is 32 (Space).

• Left Click: Toggle taskbox visibility.
• Left Drag: Move the floater window to any position on the screen.
• Right Click: Open context menu
  • Set Volume
  • Audio Output
  • Monitors: Toggle thumbnail monitoring window of connected monitors. You can click and drag inside the thumbnail to interact with the actual monitor seamlessly! Drag the edit box to move the thumbnail window, or right-click the edit box to close it.
  • System Shutdown
  • Exit
• Alt + Mouse Wheel: Adjust transparency of the floater.
• Ctrl + Mouse Wheel: Adjust top-level time and date font sizes independently and strictly while hovered or focused.

• Left Click (Icon): Activate the selected application or launch the shortcut.
• Left Drag (Task Icon/Window): Navigate drag for reordering icons, or drag the window via empty space and the top edit console.
• Toolbar Rich Interaction Buttons:
  • M Button (Menu / Move): Left Drag to move the taskbox window, or Left Click to toggle between widgets.
  • V Button (Volume): Left Click to toggle system volume Mute/Unmute state instantly. Mouse Wheel over it adjusts volume percent.
  • B Button (Brightness): Mouse Wheel adjusts screen brightness in 5% steps (Supports laptops & external monitors via Hybrid Gamma Fallback).
  • A Button (Alpha): Mouse Wheel adjusts the taskbox transparency dynamically.
  • C Button (Command Box): Left Click opens the independent Command Box console window.
  • R Button (Resize): Left Drag to resize the taskbox window dynamically.
  • X Button (Close): Left Click to hide the taskbox and reload shortcuts.
• Right Click (Task/Shortcut Icon): Opens context menu.
  • Run (&R): Launches a new instance of the application or selected shortcut.
  • Focus (&F): Activates and switches to the existing window.
  • Close Window (&X): (For Task Icons) Closes the selected application.
  • Open File Location (&O): (For Shortcut Icons) Opens the folder containing the target file.

• Dark/Light Mode Sync: Automatically inverts inner Text and Background colors natively capturing Windows systemic Light/Dark mode boundaries seamlessly gracefully in real-time.

• Win + Alt + Space (Default): Show or hide the taskbox. (Can be customized in config.ini)
  • Note: If either the floater or taskbox window is outside the screen bounds, its position is automatically reset to (0, 0) upon summoning.

• Arrow Keys / WASD: Move focus between icons.
• Space: Switch to the selected application or launch the shortcut.
• Enter: Open the context menu for the focused item. (Shortcut icons also support this)
• C: Open and focus the Command Box.
• Esc: Hide the taskbox and refresh shortcuts.

• Movement: Alt + Arrow Keys / WASD
• Reset Layout: Ctrl + R / 0 or F5 to reset position, alpha, and size.
• Font/Icon Scaling: Ctrl + +/- or Ctrl + Mouse Wheel scales text fonts and icons smoothly.
• Transparency: Alt + + / - or Alt + Mouse Wheel

• Exit Application: Ctrl + Q / X or Alt + F4.
• Context Menu: F2 (Triggers context menu for focused floater/taskbox).
• Show About: F1.
• Open Command Box: C (when Floater or Taskbox is focused).
• Open Taskbox: T (when Floater is focused).
• Execute Command: Ctrl + Enter (inside the Command Box).
• Focus Command Input: Ctrl + Space (inside the Command Box).

This project is developed and tested using the MSYS2 environment.

1. Download and install MSYS2 from the official website: https://www.msys2.org/
2. Open the MSYS2 MinGW64 terminal and install the GCC toolchain by running: pacman -S mingw-w64-x86_64-gcc
3. Add the MSYS2 MinGW64 binary path (usually C:\msys64\mingw64\bin) to your system's PATH environment variable.
4. Navigate to the project directory in the MSYS2 terminal and run build.bat.
   • Example: If your project is in D:\mydata\hgfloater, type: cd /d/mydata/hgfloater
   • Then run the build script: ./build.bat (or cmd /c build.bat)

• Author: rubidus-api (rubidus@gmail.com)
• Development Method: This application was developed using Vibe Coding with AI assistance.
• Note: The developer is a hobbyist coder, not a seasoned professional. This project is a result of creative experimentation and AI-driven collaboration.

The name "HellGates" is a playful parody of Bill Gates and Windows. It represents a collection of utilities designed to enhance the desktop experience and system responsiveness. The series was born from a desire for Windows to be a more user-friendly, lightweight, and responsive OS. Through this series, we plan to experiment with various innovative UX/UI ideas to push the boundaries of desktop interaction.

hgfloater는 윈도우 11 이상의 플랫폼에서 반투명 플로팅 박스와 최적화된 키보드/마우스 인터랙션을 통해 컴퓨터를 빠르고 반응성 있게 조작하기 위해 제작되었습니다. 순수 C와 WinAPI만을 사용하여 외부 의존성 없이 제작되었으며, 극도로 가볍고 즉각적인 반응성을 보장합니다.

hgfloater의 핵심 목표는 시스템 조작의 효율성을 극대화하는 것입니다. 현재는 단축 아이콘을 이용한 퀵 런처와 태스크 스위처 기능을 중심으로, 화면 어디에나 배치하고 단축키로 즉시 제어할 수 있는 유연한 환경을 제공합니다.

기본 윈도우 태스크바를 보완하는 동시에, 속도와 효율을 중시하는 파워 유저들을 위한 강력한 도구로 설계되었습니다. 현재의 기능은 시작에 불과하며, 차후에는 컴퓨터의 빠르고 반응성 있는 조작을 돕는 다양한 기능들을 지속적으로 추가하여 완성된 조작 환경을 구축할 예정입니다.

hgfloater는 설정의 영속성을 유지하기 위해 사용자 프로필 디렉토리 내에 데이터를 저장합니다.

• 기본 설정 폴더: %USERPROFILE%\.HellGates\hgfloater
  • 모든 애플리케이션 데이터가 저장되는 루트 폴더입니다.
• 단축 아이콘 디렉토리: %USERPROFILE%\.HellGates\hgfloater\shortcuts
  • 이 폴더에 실행 파일의 바로가기(.lnk)나 웹 링크(.url)를 넣으면 taskbox 툴바에 자동으로 나타납니다.
• 설정 파일: %USERPROFILE%\.HellGates\hgfloater\config.ini
  • 사용자 환경 설정, 창 위치, 단축키 설정 등이 저장됩니다.

설정 파일은 표준 INI 형식을 따릅니다. 프로그램을 종료한 상태에서 메모장 등으로 직접 수정할 수 있습니다.

• font_name: 에디트 컨트롤, 툴팁, 프로그램 정보(About) 등에 공통적으로 적용될 폰트의 이름입니다 (기본값: Segoe UI).

• x, y: 창의 화면 시작 좌표(좌측 상단)입니다.
• w, h: 창의 가로 및 세로 크기입니다.
• alpha: 창의 투명도 수준입니다 (128-255).
• font_size: 표시할 텍스트 폰트의 크기입니다.
• icon_size: ([taskbox] 전용) 툴바 및 활성 창 목록에 표시되는 아이콘의 크기 해상도입니다.

• global_focus_modifiers: 조합 키의 비트마스크 값입니다 (예: Alt=1, Ctrl=2, Shift=4, Win=8). 기본값은 9 (Win + Alt)입니다.
• global_focus_key: 호출 단축키의 가상 키 코드(Virtual Key Code)입니다. 기본값은 32 (Space)입니다.

• 왼쪽 클릭: taskbox 보이기/숨기기 토글.
• 왼쪽 드래그: 위젯 창을 화면 원하는 곳으로 이동.
• 오른쪽 클릭: 컨텍스트 메뉴를 엽니다.
  • Set Volume: 시스템 볼륨 조절.
  • Audio Output: 기본 오디오 출력 장치 변경.
  • Monitors: 연결된 모니터들의 썸네일을 보여주는 창 켜기/끄기. 썸네일 내부를 좌/우 클릭하거나 드래그하면 실제 모니터에 마우스 입력이 그대로 전달됩니다! 창을 이동하려면 상단의 에디트 박스를 드래그하고, 창을 닫으려면 에디트 박스를 우클릭하세요.
  • System Shutdown: 윈도우 표준 종료 메뉴(Shutdown Dialog)를 호출합니다.
  • Exit: hgfloater를 종료합니다.
• Alt + 마우스 휠: 위젯의 투명도 조절.
• Ctrl + 마우스 휠: 위젯에 마우스를 올리거나 포커싱되었을 때 시간과 날짜의 글꼴 크기를 조절.

• 아이콘 왼쪽 클릭: 해당 앱으로 전환하거나 단축 아이콘을 실행합니다.
• 아이콘/창 왼쪽 드래그: 아이콘 위치를 끌어서 순서를 변경하거나, 빈 공간 및 상단 에디트 박스를 드래그하여 창을 이동합니다.
• 툴바 버튼 다채로운 조작:
  • M 버튼 (Menu / Move): 왼쪽 드래그로 태스크 박스 창을 화면 내에서 자유롭게 이동하거나, 왼쪽 클릭으로 위젯 간 전환을 연동합니다.
  • V 버튼 (Volume): 왼쪽 클릭 시 시스템 볼륨을 즉각적으로 Mute/Unmute(음소거) 토글합니다. 버튼 위에서 마우스 휠을 돌리면 볼륨 크기를 세밀하게 증감합니다.
  • B 버튼 (Brightness): 마우스 휠을 돌려 화면 밝기를 5% 단위로 실시간 조절합니다. (노트북 내장 화면 및 외장 모니터를 모두 지원하는 하이브리드 감마 Fallback 제공)
  • A 버튼 (Alpha): 마우스 휠을 돌려 태스크 박스의 투명도를 실시간으로 동적 조절합니다.
  • C 버튼 (Command Box): 왼쪽 클릭 시 독립적인 팝업형 CLI 명령 콘솔 창(Command Box)을 호출합니다.
  • R 버튼 (Resize): 왼쪽 드래그로 태스크 박스의 가로/세로 칸수(그리드 크기)를 실시간 조절합니다.
  • X 버튼 (Close): 왼쪽 클릭 시 태스크 박스를 숨기고 단축 아이콘 목록을 즉시 갱신합니다.
• 아이콘 오른쪽 클릭 (태스크/단축 아이콘): 컨텍스트 메뉴를 엽니다.
  • Run (&R): 해당 앱의 새 인스턴스를 실행하거나 단축 아이콘을 실행합니다.
  • Focus (&F): 이미 실행 중인 해당 창으로 포커스를 전환합니다.
  • Close Window (&X): (태스크 아이콘 전용) 해당 앱을 종료합니다.
  • Open File Location (&O): (단축 아이콘 전용) 파일 위치를 엽니다.
• 상단 로그 영역 오른쪽 클릭: 누적된 전체 롤링 로그를 클립보드로 복사하는 (Copy all logs) 컨텍스트 메뉴 노출.
• Ctrl + 마우스 휠: 아이콘 크기를 조절하며 테두리 창 크기를 비례적으로 유지. 상단 에디트 박스 위에 포커스 시 에디트 박스 내부의 글꼴 크기만을 증감.
• Alt + 마우스 휠: taskbox의 투명도 조절.
• 테두리 드래그: 창의 위/아래 모서리나 변을 잡아끌거나 드래그하여 그리드 칸수를 실시간 조절.

• 다크/라이트 모드 반전: 윈도우 배색 모드를 다크나 라이트로 변경 시 실시간으로 시스템 설정에 따라 앱 내 텍스트와 배경 색상이 서로 교차 반전됨.

• Win + Alt + Space (기본값): taskbox 보이기/숨기기. (config.ini에서 변경 가능)
  • 참고: 호출 시 floater나 taskbox 창이 화면 내에 일부라도 존재하지 않는 경우, 자동으로 (0, 0) 위치로 재조정되어 복구됩니다.

• 방향키 / WASD: 아이콘 사이 포커스 이동.
• Space: 선택한 앱으로 전환하거나 바로가기 실행.
• Enter: 선택한 항목의 컨텍스트 메뉴 열기 (단축 아이콘에서도 동일하게 작동).
• C: 커맨드 박스(Command Box) 열기 및 포커스.
• Esc: taskbox 숨기기 및 바로가기 아이콘 갱신.

• 위치 이동: Alt + 방향키 / WASD
• 레이아웃 초기화: Ctrl + R / 0 또는 F5 를 누르면 크기, 투명도, 위치가 모두 리셋됩니다.
• 폰트/아이콘 크기 조절: Ctrl + +/- 또는 Ctrl + 마우스 휠
• 투명도 조절: Alt + + / - 또는 Alt + 마우스 휠

• 프로그램 종료: Ctrl + Q / X 또는 Alt + F4.
• 컨텍스트 메뉴: F2 (포커스된 창의 컨텍스트 메뉴 호출).
• 정보 창 보기: F1.
• 커맨드 박스 열기: C (플로팅 위젯/태스크 박스 포커스 시).
• 태스크 박스 열기: T (플로팅 위젯 포커스 시).
• 명령 실행: Ctrl + Enter (커맨드 박스 내부).
• 입력 창 포커스: Ctrl + Space (커맨드 박스 내부).

본 프로젝트는 MSYS2 환경을 기준으로 작성 및 테스트되었습니다.

1. MSYS2 공식 사이트(https://www.msys2.org/)에서 설치 프로그램을 다운로드하여 설치합니다.
2. MSYS2 MinGW64 터미널을 열고 다음 명령어를 입력하여 GCC 툴체인을 설치합니다: pacman -S mingw-w64-x86_64-gcc
3. MSYS2의 MinGW64 바이너리 경로(기본값: C:\msys64\mingw64\bin)를 시스템 환경 변수 PATH에 추가합니다.
4. MSYS2 터미널에서 프로젝트 폴더로 이동한 뒤 build.bat를 실행합니다.
   • 이동 예시: 프로젝트가 D:\mydata\hgfloater 폴더에 있다면 다음과 같이 입력합니다: cd /d/mydata/hgfloater (MSYS2에서는 드라이브 문자를 /d/와 같이 표시합니다.)
   • 실행: 폴더 이동 후 다음 명령어로 빌드 스크립트를 실행합니다: ./build.bat (또는 cmd /c build.bat)

• 제작자: rubidus-api (rubidus@gmail.com)
• 제작 방식: 이 프로그램은 AI의 도움을 받은 **바이브 코딩(Vibe Coding)**을 통해 제작되었습니다.
• 참고: 제작자는 전문적인 경력이 많은 프로그래머가 아닌 취미로 코딩을 즐기는 사람입니다. 이 프로젝트는 창의적인 실험과 AI와의 협업을 통해 만들어진 결과물입니다.

"HellGates"라는 이름은 빌 게이츠(Bill Gates)와 윈도우(Windows)에 대한 유머러스한 패러디를 담고 있습니다. 이는 데스크톱 사용 경험과 반응성을 개선하기 위한 일련의 프로그램 집합을 의미합니다. MS의 윈도우 OS가 사용자 입장에서 더 편리하고, 가볍고, 반응이 빠른 운영체제가 되기를 바라는 마음에서 시작되었습니다. 이 시리즈를 통해 UX/UI에 대한 다양한 실험적인 아이디어들을 적용해 나갈 예정입니다.