Logitech G HUB 가이드

Logitech G HUB 매크로를 설치·설정하거나 직접 만드는 방법

기본 G HUB 매크로와 프로필 Lua 스크립트를 구분하고, 마우스 버튼 지정, 앱별 프로필, 재생 방식, 온보드 메모리 한계, 안전한 테스트와 단계별 진단까지 설명합니다.

EasyMacro 편집팀 15분 게시일:
어두운 책상에서 추상적인 매크로 타임라인 앞에 놓인 로고 없는 프로그래밍 가능 게이밍 마우스
안정적인 설정은 파일 형식과 프로필을 올바르게 고르고 반복 전에 한 번만 통제해 시험하는 것에서 시작합니다.

먼저 파일 형식을 확인하세요

일반 동작 순서는 Assignments → Macros에서 만들고 마우스 버튼으로 끌어 놓습니다. 받은 파일이 .lua라면 표준 기록기가 아니라 올바른 프로필의 Scripting 편집기를 사용해야 합니다.

화면을 포함한 짧은 절차는 TopMacro 한국어 Logitech G HUB 가이드에서도 확인할 수 있습니다. 아래 내용은 최신 Logitech 자료를 바탕으로 독립적으로 작성하고 진단 정보를 확장했습니다.

기본 매크로, Lua, 온보드 메모리를 구분하세요

G HUB는 한 장치에 여러 자동화 방식을 제공합니다. 다른 모델의 메뉴를 그대로 따라가기보다 원하는 결과와 로직이 실행될 위치를 기준으로 고르세요.

방식적합한 용도주요 제한
기본 G HUB 매크로키, 클릭, 텍스트, 명령과 선형 동작 순서G HUB를 통해 실행되며 지원 버튼에 지정해야 함
프로필 Lua 스크립트Scripting이 지원하는 조건과 이벤트모든 장치, 시스템, 빌드에서 제공되지 않음
온보드 지정G HUB 없이 휴대할 단순 버튼복잡한 반복, 시퀀스, 전체 스크립트를 저장하지 못함

.lua는 두 번째 방식이고 Assignments에서 기록한 순서는 첫 번째입니다. On-Board Memory가 이를 제한 없는 펌웨어 자동화로 바꾸지는 않습니다.

기본 매크로 타임라인, 프로필 스크립트, 온보드 메모리의 세 경로
동작을 어디에 정의하고 G HUB를 계속 실행할지에 따라 올바른 설치 경로가 정해집니다.

G HUB, 장치, 되돌릴 방법을 준비하세요

불러오기 전에 시작 상태를 기록하면 잘못된 프로필이나 주 버튼 재지정을 장치 고장으로 오해하지 않습니다.

  • 공식 G HUB를 설치하세요. 업데이트를 끝내고 대상 마우스를 다시 연결하여 설정 화면이 정상적으로 열리는지 확인합니다.
  • 다운로드를 검사하세요. 압축을 풀고 검사한 뒤 설명을 읽습니다. 데이터나 스크립트만 있어야 하는데 실행 파일이 있으면 실행하지 마세요.
  • 현재 배치를 저장하세요. 프로필과 버튼 지도를 캡처하고 기본 클릭을 유지하며 필요하면 예비 마우스를 준비합니다.
  • 실제 앱 프로필을 선택하세요. 주 실행 파일에 연결합니다. Desktop Default는 중립 백업이지 모든 매크로의 필수 위치가 아닙니다.
  • 끝나는 한 동작부터 시험하세요. 시작, 간격, 정지가 분명해질 때까지 안전한 창과 측면 버튼을 사용합니다.

기본 G HUB 매크로 만들기와 지정

내장 편집기는 단축키, 통제된 클릭, 텍스트와 앱 명령에 적합합니다. 짧은 버전을 먼저 검증하고 그다음 반복을 추가하세요.

  1. 올바른 장치를 여세요.

    연결된 마우스와 화면에 표시된 앱 프로필을 확인합니다.

  2. Assignments → Macros로 이동하세요.

    Create New Macro를 누르고 앱과 용도가 드러나는 이름을 줍니다.

  3. 재생 방식을 고르세요.

    No Repeat로 시작하고 다른 방식은 명확한 정지 조건이 있을 때만 씁니다.

  4. 동작을 추가하세요.

    키보드, 마우스, 텍스트, 지원 명령을 기록하고 우발 입력을 지웁니다.

  5. 지연과 해제를 확인하세요.

    앱 처리 시간을 남기고 누른 키나 버튼을 모두 해제합니다.

  6. 버튼에 지정하세요.

    저장한 뒤 마우스 그림으로 끌어 놓고 시험 전 새 표시를 확인합니다.

목록에 매크로가 있지만 버튼은 예전 동작을 한다면 기록은 성공했고 지정 또는 활성 프로필이 잘못된 것입니다. 복제본을 다시 만들 필요가 없습니다.

프로필 Lua 스크립트를 올바르게 불러오기

Lua는 G HUB가 실행되는 동안 프로필의 지원 이벤트에 반응합니다. 해당 프로필에 Scripting이 실제로 보일 때만 이 방식을 사용하세요.

  1. 대상 프로필을 고르세요.

    Desktop 또는 다른 게임에 저장한 스크립트는 올바른 실행 파일로 자동 이동하지 않습니다.

  2. Scripting을 여세요.

    없다면 모델, 플랫폼, 펌웨어와 지원 상태를 확인합니다.

  3. 기존 코드를 백업하세요.

    가져오기가 덮어쓸 수 있으므로 날짜가 있는 텍스트로 저장합니다.

  4. .lua를 불러오세요.

    열기 또는 가져오기를 사용하고 설정, 주석, 이벤트 처리기를 읽은 뒤 저장합니다.

  5. 프로필을 활성화하세요.

    연결된 앱으로 이동하고 로그에서 프로필과 예상 버튼 이벤트를 확인합니다.

  6. 한 번만 통제해 시험하세요.

    안전한 환경과 분명한 정지를 사용하고 이벤트가 없을 때는 시간값부터 바꾸지 않습니다.

모르는 코드를 검토 없이 붙여 넣지 마세요.

Lua는 읽을 수 있는 프로그램 로직입니다. 파일 접근, 외부 명령, 무한 반복, 설명 없는 설정을 살피고 원본과 작업본을 분리하세요.

버튼과 프로필을 예측 가능하게 만드세요

간헐적 오류는 흔히 프로필 전환 문제입니다. G HUB는 실행 파일에 따라 전환하고, 고정 프로필은 같은 배치를 전체에 적용합니다. 두 동작을 따로 확인하세요.

  1. 실행 파일 연결을 확인하세요.

    런처나 업데이트 프로그램이 아니라 주 프로세스에 연결합니다.

  2. 안전한 트리거를 선택하세요.

    측면 버튼부터 쓰고 대체 수단 없이 기본 클릭을 바꾸지 않습니다.

  3. 표시를 확인하세요.

    기본 매크로는 버튼에 이름이 보이고 Lua는 지원 이벤트를 감지합니다.

  4. 전환을 관찰하세요.

    Desktop과 대상 앱을 오가며 프로필 이름을 확인합니다.

  5. 고정은 진단용으로만 쓰세요.

    알려진 프로필을 잠깐 고정하고 원인을 찾은 뒤 앱별 전환을 복원합니다.

올바른 장치연결된 마우스의 배치를 편집함
올바른 프로필실행 중인 앱이 의도한 설정을 선택함
올바른 버튼물리 입력과 지정 또는 이벤트가 일치함
분명한 정지해제, 완료 또는 검증된 정지 동작으로 끝남

온보드 메모리 한계를 고려해 재생을 고르세요

PC의 G HUB와 마우스 내부는 같은 실행 환경이 아닙니다. 먼저 소프트웨어 모드에서 확인한 뒤 단순한 휴대용 지정으로 충분한지 결정합니다.

방식 또는 저장 위치실용 용도확인 사항
No Repeat한 번 끝나는 단축키 또는 순서모든 키가 해제되고 순서가 종료됨
Repeat While Holding물리적으로 놓을 때까지 반복Logitech 문서상 온보드에서 작동하지 않음
Toggle / Sequence상태 전환과 다단계 흐름데스크톱 G HUB가 필요함
On-Board Memory휴대 가능한 기본 버튼호환 슬롯을 저장하고 데스크톱 기능을 가정하지 않고 시험함

On-Board Memory가 켜지면 G HUB에서 평소처럼 편집하지 못합니다. 변경하려면 software mode로 돌아가거나 지원 모델에만 Onboard Memory Manager를 사용합니다.

이해하기 쉬운 나만의 매크로 설계

관리하기 좋은 매크로는 허용된 한 가지 일을 수행하고 시작이 분명하며 끝을 확인할 수 있습니다. 기록 전에 동작을 평문으로 적으세요.

  1. 결과 하나를 정하세요.

    앱 명령, 허용된 고정 문구 또는 짧은 접근성 단축키 등입니다.

  2. 누름, 대기, 해제로 나누세요.

    각 이벤트와 예상 앱 상태를 기록합니다.

  3. 가장 단순한 도구를 쓰세요.

    선형 순서는 Macros, 지원 조건은 Lua, 기본 휴대 기능은 온보드를 사용합니다.

  4. 최소 순서를 만드세요.

    우발 입력을 제거하고 프로필, 매크로, 백업 이름을 명확히 합니다.

  5. 한 주기를 시험하세요.

    순서를 보고 지연을 하나씩 바꾸며 속도보다 안정성을 우선합니다.

  6. 작동 상태를 기록하세요.

    장치, 모드, 프로필, 버튼, 재생과 날짜를 남깁니다.

Lua에서는 먼저 프로필 활성화와 버튼 이벤트를 로그로 확인하세요. 트리거가 도착하지 않으면 실행 부분을 고쳐도 해결되지 않습니다.

프로필, 버전, 백업을 정리하세요

일반 버튼의 중립 Desktop과 앱별 프로필을 따로 둡니다. 목적이 드러나는 이름은 자동 전환 시 현재 설정을 바로 보여 줍니다.

검증 후 버튼 지도, Lua 원본, 장치, G HUB 버전, 실행 파일, 재생 방식, 날짜 메모를 설치 폴더 밖에 보관합니다.

지원 마우스와 앱용 준비 파일이 필요하면 EasyMacro 카탈로그에서 소프트웨어, 모델, 설정 조건을 구매 전에 확인하세요.

Logitech G HUB 매크로가 작동하지 않을 때

장치, 파일 형식, 프로필, 트리거, 권한, 규칙 순으로 점검합니다. 무작정 재설치하면 잘못된 프로필은 남고 단서만 사라집니다.

Assignments 또는 Scripting이 없음

정확한 모델, 운영체제, 펌웨어와 현재 지원 여부를 확인합니다.

.lua가 Macros에 표시되지 않음

정상입니다. 대상 프로필의 Scripting을 엽니다.

버튼이 예전 기능을 유지함

매크로를 끌어 놓고 표시와 활성 프로필을 확인합니다.

Desktop에서는 되고 앱에서는 안 됨

실행 파일 연결과 권한을 맞추고 G HUB를 항상 관리자로 실행하지 않습니다.

이벤트가 빠지거나 눌린 채 남음

누름/해제 쌍, 짧은 지연, 한 주기 중립 시험을 확인합니다.

온보드에서만 실패함

software mode로 돌아갑니다. Repeat While Holding, Toggle, Sequence, Lua는 문서화된 범위 밖입니다.

화면을 포함한 보조 자료로 TopMacro 한국어 Logitech 매크로 글도 확인하세요.

규칙이 허용하는 곳에서만 자동화를 사용하세요

G HUB는 공식 소프트웨어지만 모든 동작 순서가 모든 게임에서 허용되는 것은 아닙니다. 운영사, 서버, 리그, 대회는 다중 동작, 반복, 반동 보정, 무인 플레이를 제한할 수 있습니다.

정확한 게임, 서버, 모드의 최신 규칙을 읽으세요. 업무, 접근성, 창작 도구, 오프라인 시험은 목적이 더 분명하지만 판매자가 미래의 판정을 보장할 수는 없습니다.

일반 프로필을 유지하고 끝나는 시험부터 시작하며 즉시 멈출 수 있어야 합니다. 좋은 설정은 이해할 수 있고 되돌릴 수 있으며 해당 상황에서 허용됩니다.

출처와 편집 검증

이 글은 독립적으로 작성하고 최신 Logitech 1차 자료로 확인했습니다. TopMacro 링크는 요청된 한국어 참고 페이지이며 문장이나 문단 구조를 복사하지 않았습니다.

사실과 링크는 2026년 8월 22일 확인했습니다. 이후 G HUB 업데이트에서 메뉴와 기능이 달라질 수 있습니다.

자주 묻는 질문

Logitech G HUB 매크로 관련 질문

Logitech G HUB에서 매크로를 어떻게 만드나요?

대상 마우스를 열고 Assignments, Macros, Create New Macro 순서로 이동합니다. 알아보기 쉬운 이름과 재생 방식을 고르고 동작을 기록하거나 추가한 뒤 저장하여 프로그래밍 가능 버튼으로 끌어 놓습니다.

.lua 파일을 일반 매크로 편집기에서 가져올 수 있나요?

아니요. .lua는 일반 매크로가 아니라 프로필 스크립트입니다. 장치, 운영체제, 현재 G HUB 버전이 지원할 때 대상 앱 프로필의 Scripting에서 불러옵니다.

바탕 화면에서는 되는데 게임에서는 안 되는 이유는 무엇인가요?

활성 프로필과 실제 실행 파일 연결을 확인하세요. Logitech은 G HUB와 대상 프로그램의 권한 수준을 같게 하라고 안내합니다. 대상이 관리자 권한일 때만 G HUB도 같은 권한으로 실행하세요. 게임 규칙이 자동화를 제한할 수도 있습니다.

모든 Logitech 마우스가 Lua와 온보드 메모리를 지원하나요?

아니요. 모델, 플랫폼, 펌웨어, G HUB 버전에 따라 다릅니다. 표시되지 않는 Scripting 또는 On-Board Memory 기능을 파일로 추가할 수 없습니다.

온보드 메모리 모드에서 매크로가 멈추는 이유는 무엇인가요?

마우스 내부 기능은 데스크톱 G HUB보다 제한적입니다. Logitech 문서상 Repeat While Holding, Toggle, Sequence는 온보드에서 실행되지 않으며 Lua도 G HUB가 켜져 있어야 합니다.

Desktop 프로필을 항상 고정해야 하나요?

보통은 아닙니다. 실제 앱에 별도 프로필을 연결하고 바탕 화면에는 일반 버튼을 남기세요. 고정 Desktop은 자동 전환 문제를 확인하는 임시 진단용입니다.

Logitech 매크로는 모든 게임에서 허용되나요?

아니요. 공식 장치 소프트웨어도 게임, 서버, 리그, 대회 규칙을 바꾸지 못합니다. 반복, 한 번의 입력으로 여러 동작, 반동 보정, 무인 플레이 규정을 확인하세요.