Timeshit

프로그램 소개

Timeshit는 macOS, Linux, Windows에서 실행되는 터미널 기반 애플리케이션으로, Toggl Track에 기록된 작업 시간을 시각적인 대시보드 형태로 보여줍니다. 월별/주별 요약, 특별 휴가일 처리, 클립보드 복사 등 실용적인 기능을 제공합니다.

주요 기능

• 모던 TUI 대시보드: 프로젝트별 시간 요약과 상세 항목을 그룹화하여 표시합니다.
• 날짜 범위 필터링: 키보드 단축키(‘d’)로 빠르게 조회 기간을 설정할 수 있습니다.
• 요약 및 근무시간 계산: 주간/월간/연간 요약을 통해 총 근무시간과 초과근무 잔액을 확인할 수 있습니다.
• 테마 스튜디오: 내장된 7가지 테마와 브라우저 기반 커스텀 테마 스튜디오를 지원합니다.
• 클립보드 내보내기:</고객별(c), 프로젝트별(v), 고객+프로젝트별(x)로 항목을 복사하여 다른 타임시트 도구에 붙여넣기할 수 있습니다.

다운로드·설치 방법

Windows 사용자는 다음 명령어로 설치할 수 있습니다.

• Chocolatey: choco install timeshit
• Scoop: 먼저 nxt-solutions 버킷을 추가한 후 scoop install timeshit을 실행합니다.
• Winget: winget install NxTSolutions.Timeshit

macOS는 Homebrew(권장), Linux는 APT를 통해 설치할 수 있으며, 모든 OS에서 GitHub Releases의 바이너리를 다운로드하여 사용할 수 있습니다.

기본 사용법

설치 후 터미널에서 timeshit을 입력하여 실행합니다. 주요 조작 키는 다음과 같습니다:

• h: 도움말 화면 표시
• g: 테마 스튜디오 열기
• d: 날짜 범위 설정
• o: 요약(롤업) 화면 열기
• r: 데이터 새로고침

설정은 앱 내 메뉴(Settings → Integrations) 또는 환경 변수 TOGGL_API_TOKEN을 통해 API 토큰을 구성할 수 있습니다.

이런 경우에 유용합니다

Toggl Track을 사용하여 프로젝트별 근무시간을 기록하는 프리랜서, 팀원, 또는 관리자에게 적합합니다. 주간/월간 근무시간 요약이 필요하거나, 다른 타임시트 시스템으로 시간 기록을 내보내야 하는 경우 유용하게 활용할 수 있습니다.

지원 환경·시스템 요구사항

macOS, Linux, Windows를 지원합니다. 모든 버전은 GitHub Releases에서 제공되는 바이너리 또는 패키지 관리자를 통해 설치할 수 있습니다.

최신 버전·업데이트

최신 버전은 GitHub Releases 페이지에서 확인할 수 있습니다. 패키지 관리자(Homebrew, Chocolatey 등)로 설치한 경우 해당 관리자를 통해 업데이트할 수 있습니다.

제한 사항·확인 사항

• Toggl Track API 토큰이 필요합니다. 설정 메뉴 또는 환경 변수를 통해 구성해야 합니다.
• 기본 등급 API 호출 제한을 줄이기 위해 영속 캐시를 사용하지만, 주기적인 수동 새로고침이 필요할 수 있습니다.

FAQ

• 무료로 사용할 수 있나요? 네, Timeshit는 MIT 라이선스로 배포되는 무료 오픈소스 소프트웨어입니다.
• Windows에서 실행할 수 있나요? 네, Chocolatey, Scoop, Winget을 통해 Windows에 설치할 수 있습니다.
• 인터넷 연결이 필요한가요? Toggl Track 데이터를 가져오려면 인터넷 연결이 필요합니다.

화면으로 보는 주요 기능

프로젝트 목록 화면

메인 대시보드에서 워크스페이스의 프로젝트별 근무시간 목록과 선택된 프로젝트의 상세 항목이 표시됩니다.

도움말 화면

모든 키보드 단축키와 기능을 카테고리별로 정리한 도움말 목록이 표시됩니다.

설정 화면

테마, 목표 근무시간, 시간 반올림 등 앱 기본 설정을 구성할 수 있는 화면입니다.

월간 요약 화면

월별 총 근무시간, 목표 시간, 초과근무(edelta), 일일 평균 등을 요약하여 보여주는 화면입니다.