CLI 도구를 만들어 Gmail에서 OTP를 자동 복사 — 탭 전환은 이제 그만

Source: Dev.to

Overview

서비스에 로그인할 때마다 보통 다음과 같이 합니다:

1. 이메일과 비밀번호 입력
2. OTP 이메일을 기다림
3. Gmail으로 전환해 이메일을 찾고 6자리 코드를 복사
4. 다시 전환해 코드를 붙여넣고 만료되기 전에 사용

하루에 수십 번씩 이 과정을 반복하면 많은 시간이 낭비됩니다. OTPilot은 이 과정을 자동화합니다:

• 백그라운드에서 조용히 실행
• 핫키를 눌러 최근 10개의 Gmail 메시지를 가져오고, OTP를 추출해 클립보드에 복사한 뒤 데스크톱 알림을 표시
• 탭 전환이나 대기 없이 바로 붙여넣기 가능

Installation

pip install otpilot

Requirements

• Python 3.8+
• Gmail 계정
• Gmail API가 활성화된 Google Cloud 프로젝트 (무료; 한 번만 ~5분 설정)

Setup

설정 마법사를 실행해 OTPilot을 구성합니다:

otpilot setup

마법사는 다음 과정을 안내합니다:

1. Google 인증 정보 가져오기
2. 한 번만 수행되는 Gmail 로그인 (읽기 전용 접근 권한 OAuth)
3. 원하는 핫키 설정

설정이 끝나면 데몬을 시작합니다:

otpilot start

시스템 트레이에 상주하며 핫키를 기다립니다.

Clipboard support on Linux

OTPilot은 클립보드 작업을 위해 xclip 또는 xsel을 사용합니다. 둘 중 하나를 설치하세요:

sudo apt install xclip   # or sudo apt install xsel

Usage

설정한 핫키를 누르세요. OTPilot은 다음을 수행합니다:

• Gmail에서 최신 10개의 이메일을 가져옴
• 이메일 본문에서 OTP를 찾음
• OTP를 클립보드에 복사
• 데스크톱 알림을 표시

Security & Privacy

• Google 인증 정보는 절대 머신을 떠나지 않습니다.
• 접근 권한은 읽기 전용이며, OTPilot은 이메일을 보내거나 삭제하거나 수정할 수 없습니다.
• 이메일은 핫키를 눌렀을 때만 가져오며, 백그라운드에서 지속적으로 폴링하지 않습니다.
• OAuth 토큰은 ~/.otpilot/에 로컬로 저장됩니다.

Platform Support

• macOS
• Linux (xclip/xsel 필요)
• Windows

Links

• GitHub:
• Website:

License

MIT 라이선스. 특히 다양한 서비스가 이메일 형식을 다르게 사용하므로 OTP 추출 패턴 개선을 위한 피드백 및 기여를 환영합니다.