{"id":32930030,"url":"https://github.com/maantano/maantano-ticker","last_synced_at":"2025-11-11T13:02:29.437Z","repository":{"id":318828296,"uuid":"1076627840","full_name":"maantano/maantano-ticker","owner":"maantano","description":"Real-time Korean Stock Market Ticker for macOS Menu Bar with Extended Hours Trading Support 🇰🇷📈","archived":false,"fork":false,"pushed_at":"2025-11-06T08:35:01.000Z","size":1646,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-06T10:23:21.114Z","etag":null,"topics":["electron","finance","homebrew","korean-stock","macos","menubar-app","naver-finance","real-time","stock-market","stock-ticker","ticker","trading"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/maantano.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-15T06:07:42.000Z","updated_at":"2025-11-06T08:55:24.000Z","dependencies_parsed_at":"2025-10-16T13:32:09.074Z","dependency_job_id":"f3650bc9-e193-451a-98d8-10ff75086a02","html_url":"https://github.com/maantano/maantano-ticker","commit_stats":null,"previous_names":["maantano/maantano-ticker"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/maantano/maantano-ticker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maantano%2Fmaantano-ticker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maantano%2Fmaantano-ticker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maantano%2Fmaantano-ticker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maantano%2Fmaantano-ticker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maantano","download_url":"https://codeload.github.com/maantano/maantano-ticker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maantano%2Fmaantano-ticker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":283854603,"owners_count":26906029,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-11-11T02:00:06.610Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["electron","finance","homebrew","korean-stock","macos","menubar-app","naver-finance","real-time","stock-market","stock-ticker","ticker","trading"],"created_at":"2025-11-11T13:01:03.070Z","updated_at":"2025-11-11T13:02:29.428Z","avatar_url":"https://github.com/maantano.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Maantano Ticker\n\n\u003cdiv align=\"center\"\u003e\n\n**macOS 메뉴바에서 한국 및 미국 주식 실시간 시세를 확인하는 앱**\n\n![Version](https://img.shields.io/badge/version-1.4.0-blue)\n![Platform](https://img.shields.io/badge/platform-macOS-lightgrey)\n![License](https://img.shields.io/badge/license-MIT-green)\n[![Homebrew](https://img.shields.io/badge/homebrew-available-orange)](https://github.com/maantano/homebrew-maantano)\n\n\u003c/div\u003e\n\n## 📱 소개\n\nMaantano Ticker는 macOS 메뉴바에 실시간 주식 시세를 표시하는 경량 데스크톱 앱입니다. 한국(네이버 증권 API) 및 미국(Yahoo Finance API) 주식을 모두 지원하며, 깔끔한 UI와 편리한 기능으로 주식 투자자들의 모니터링을 돕습니다.\n\n\u003e **⚠️ 주의**: 메뉴바에 위젯이 너무 많거나, 텍스트 크기가 메뉴바보다 클 경우 정보가 잘려서 보이지 않을 수 있습니다. 이 경우 설정에서 텍스트 크기를 줄이거나 다른 메뉴바 위젯을 제거해주세요.\n\n## 🎬 데모\n\n\u003cdiv align=\"center\"\u003e\n\n![Maantano Ticker Demo](./assets/demo.gif)\n\n\u003c/div\u003e\n\n### 기능\n\n- 🌏 **다중 시장 지원**: 한국 주식(KOSPI/KOSDAQ) 및 미국 주식(NASDAQ/NYSE/AMEX) 동시 지원\n- 📊 **실시간 시세 조회**: 네이버 증권 + Yahoo Finance API를 통한 실시간 주가 데이터\n- 🖥️ **메뉴바 통합**: macOS 메뉴바에 첫 번째 종목의 현재가, 등락률 표시\n- 🎨 **색상 커스터마이징**: 메뉴바 텍스트 색상을 10가지 컬러로 변경 가능\n- 📏 **텍스트 크기 조절**: Tiny, Small, Medium, Large 4가지 크기 옵션\n- 📈 **다중 종목 관리**: 여러 종목을 동시에 추적 및 관리\n- 🔍 **스마트 검색**: 종목명/코드 자동완성 검색\n  - 한국: 코스피/코스닥 4,000+ 종목\n  - 미국: 주요 100+ 종목 (AAPL, MSFT, TSLA 등)\n- ⏱️ **자동 업데이트**: 5초 간격 자동 시세 갱신\n- 🕐 **거래 시간 지원**:\n  - 한국: 정규장 09:00-15:30, 시간외 단일가 08:30-09:00, 시간외 종가 15:40-18:00\n  - 미국: 정규장 09:30-16:00 (EST/EDT)\n\n## 🚀 시작하기\n\n### 요구사항\n\n- macOS 10.14 (Mojave) 이상\n- Node.js 20.x 이상\n\n### 다운로드 및 설치\n\n#### Homebrew로 설치 (권장)\n\n**가장 간편한 방법입니다.** Gatekeeper 경고 없이 바로 실행됩니다.\n\n```bash\n# 설치\nbrew install --cask --no-quarantine maantano/maantano/maantano-ticker\n\n# 업그레이드\nbrew upgrade --cask maantano-ticker\n\n# 삭제\nbrew uninstall --cask maantano-ticker\n```\n\n#### 소스에서 빌드\n\n```bash\n# 저장소 클론\ngit clone https://github.com/YOUR_USERNAME/maantano-ticker.git\ncd maantano-ticker\n\n# 의존성 설치\nnpm install\n\n# 개발 모드로 실행\nnpm run dev\n\n# 프로덕션 빌드\nnpm run build\n```\n\n빌드된 앱은 `dist/` 폴더에 생성됩니다.\n\n## 📖 사용법\n\n### 첫 실행\n\n1. 앱을 실행하면 메뉴바에 차트 아이콘이 표시됩니다\n2. 아이콘을 클릭하여 메인 창을 엽니다\n3. 환영 메시지를 확인하고 \"확인\" 버튼을 클릭합니다\n\n### 종목 추가\n\n1. 메인 창에서 **\"+ 종목 추가\"** 버튼 클릭\n2. 검색창에 종목명 또는 코드 입력 (예: \"삼성전자\", \"005930\")\n3. 자동완성 목록에서 원하는 종목 선택\n4. 종목이 리스트에 추가됨\n\n### 종목 관리\n\n- **순서 변경**: 종목을 드래그 앤 드롭으로 이동\n- **종목 삭제**: 각 종목 우측의 \"삭제\" 버튼 클릭\n- **수동 업데이트**: 하단의 새로고침 버튼 클릭\n\n### 메뉴바 색상 변경\n\n1. 하단의 설정(⚙️) 버튼 클릭\n2. \"텍스트 색상\" 섹션에서 원하는 색상 선택\n3. 메뉴바 텍스트 색상이 즉시 변경됨\n\n### 기술 스택\n\n**프론트엔드**\n\n- Electron 28.x - 데스크톱 앱 프레임워크\n- Vanilla JavaScript - UI 로직\n- CSS3 - 스타일링\n\n**백엔드**\n\n- Node.js - 런타임\n- axios - HTTP 요청\n- cheerio - HTML 파싱 (웹 스크래핑)\n- canvas - 메뉴바 아이콘 렌더링\n- electron-store - 로컬 데이터 저장\n\n**개발 도구**\n\n- electron-builder - 앱 빌드 및 패키징\n- standard-version - 자동 버전 관리\n- GitHub Actions - CI/CD 자동화\n\n## 📝 버전 관리 및 배포\n\n이 프로젝트는 [Semantic Versioning](https://semver.org/)과 [Conventional Commits](https://www.conventionalcommits.org/)를 따릅니다.\n\n자세한 릴리스 프로세스는 [RELEASE.md](./RELEASE.md)를 참조하세요.\n\n## ⚠️ 면책 조항 및 주의사항\n\n### 데이터 정확성\n\n- 제공되는 주식 시세 데이터의 정확성을 보장하지 않습니다\n- 이 데이터를 바탕으로 한 투자 결정에 대한 책임은 전적으로 사용자에게 있습니다\n- **투자 손실에 대해 개발자는 어떠한 책임도 지지 않습니다**\n\n### 사용 제한\n\n- 과도한 API 요청으로 인한 IP 차단 가능성이 있습니다\n- 개인적인 용도로만 사용하시기 바랍니다\n- 상업적 사용 또는 대량 배포 시 네이버 측에서 법적 조치를 취할 수 있습니다\n- 네이버 금융의 robots.txt 및 이용약관을 준수해야 합니다\n\n**이 앱을 다운로드하거나 사용함으로써, 위의 모든 조항에 동의하는 것으로 간주됩니다.**\n\n## 📄 라이선스\n\n이 프로젝트는 MIT 라이선스 하에 배포됩니다. 자세한 내용은 [LICENSE](./LICENSE) 파일을 참조하세요.\n\n**단, 네이버 금융 데이터의 저작권은 네이버에 있으며, 이 라이선스는 해당 데이터에 적용되지 않습니다.**\n\n## 🙏 Credits\n\n- 차트 아이콘: [Freepik - Flaticon](https://www.flaticon.com/kr/free-icons/)\n- 뒤로 화살표 아이콘: [Andrean Prabowo - Flaticon](https://www.flaticon.com/kr/free-icons/-)\n- 주식 데이터: 네이버 금융\n\n## 💬 문의 및 지원\n\n- 버그 리포트: [Issues](../../issues)\n- 기능 요청: [Issues](../../issues)\n- 문의: contact@maantano-ticker.com\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Maantano Ticker**로 더 스마트한 투자 모니터링을 경험하세요!\n\n⭐ 이 프로젝트가 도움이 되셨다면 Star를 눌러주세요!\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaantano%2Fmaantano-ticker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaantano%2Fmaantano-ticker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaantano%2Fmaantano-ticker/lists"}