{"id":51026958,"url":"https://github.com/gitstq/wifidash","last_synced_at":"2026-06-21T20:02:47.520Z","repository":{"id":358483439,"uuid":"1241578933","full_name":"gitstq/wifidash","owner":"gitstq","description":"WiFiDash - 智能WiFi网络诊断与可视化工具 / Smart WiFi Network Diagnostics \u0026 Visualization Tool","archived":false,"fork":false,"pushed_at":"2026-05-17T15:11:40.000Z","size":26,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-17T17:35:50.024Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","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/gitstq.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2026-05-17T15:08:34.000Z","updated_at":"2026-05-17T15:11:41.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gitstq/wifidash","commit_stats":null,"previous_names":["gitstq/wifidash"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/gitstq/wifidash","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fwifidash","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fwifidash/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fwifidash/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fwifidash/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gitstq","download_url":"https://codeload.github.com/gitstq/wifidash/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fwifidash/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34623906,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-21T02:00:05.568Z","response_time":54,"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":[],"created_at":"2026-06-21T20:02:47.408Z","updated_at":"2026-06-21T20:02:47.491Z","avatar_url":"https://github.com/gitstq.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# 📡 WiFiDash\n\n**智能WiFi网络诊断与可视化工具**\n**Smart WiFi Network Diagnostics \u0026 Visualization Tool**\n\n[![Python](https://img.shields.io/badge/Python-3.8+-blue.svg)](https://python.org)\n[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![Platform](https://img.shields.io/badge/Platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey.svg)]()\n[![TUI](https://img.shields.io/badge/TUI-Textual-orange.svg)](https://textual.textualize.io/)\n\n[简体中文](#简体中文) | [繁體中文](#繁體中文) | [English](#english)\n\n\u003c/div\u003e\n\n---\n\n## 简体中文\n\n### 🎉 项目介绍\n\nWiFiDash 是一款智能WiFi网络诊断与可视化工具，帮助用户快速了解周围的WiFi环境，优化网络配置，提升上网体验。\n\n**灵感来源**：在日常开发和办公中，经常遇到WiFi信号不稳定、信道拥堵等问题。市面上虽然有一些WiFi分析工具，但要么功能复杂难用，要么需要付费。WiFiDash 旨在提供一个**简洁、高效、开源**的替代方案。\n\n**自研差异化亮点**：\n- 🎨 美观的TUI界面，无需浏览器即可使用\n- 📊 实时信道分析和拥堵检测\n- 💡 智能优化建议（最佳信道推荐、安全提醒）\n- 🔧 支持CLI和TUI两种使用模式\n- 📤 一键导出扫描结果\n\n### ✨ 核心特性\n\n| 特性 | 描述 |\n|------|------|\n| 📶 **网络扫描** | 扫描周围所有WiFi网络，显示SSID、信号强度、加密方式等 |\n| 📊 **信道分析** | 分析2.4GHz和5GHz信道使用情况，检测拥堵 |\n| 💡 **智能建议** | 自动推荐最佳信道，检测安全漏洞 |\n| 🖥️ **交互式TUI** | 基于Textual的美观终端界面 |\n| ⌨️ **CLI支持** | 支持命令行操作，方便脚本集成 |\n| 📤 **数据导出** | 支持JSON格式导出，便于后续分析 |\n| 🔒 **安全检测** | 自动识别开放网络、WEP等不安全加密 |\n\n### 🚀 快速开始\n\n#### 环境要求\n\n- Python 3.8+\n- Linux/macOS/Windows\n- 可选：WiFi网卡（用于真实扫描，否则使用演示数据）\n\n#### 安装\n\n```bash\n# 从PyPI安装（推荐）\npip install wifidash\n\n# 或从源码安装\ngit clone https://github.com/gitstq/wifidash.git\ncd wifidash\npip install -e .\n```\n\n#### 启动TUI界面\n\n```bash\nwifidash\n```\n\n#### CLI命令\n\n```bash\n# 扫描WiFi网络\nwifidash scan\n\n# 以JSON格式输出\nwifidash scan --json\n\n# 导出到文件\nwifidash scan --export results.json\n\n# 分析信道\nwifidash channels\n\n# 获取优化建议\nwifidash recommend\n\n# 持续监控模式\nwifidash monitor --interval 5\n```\n\n### 📖 详细使用指南\n\n#### TUI界面操作\n\n| 快捷键 | 功能 |\n|--------|------|\n| `r` | 刷新扫描 |\n| `a` | 切换自动扫描 |\n| `e` | 导出数据 |\n| `q` | 退出 |\n| `?` | 显示帮助 |\n\n#### 信号强度解读\n\n| 信号强度 | 质量 | 说明 |\n|----------|------|------|\n| -30 ~ -50 dBm | 🟢 优秀 | 信号很强，适合高清视频、游戏 |\n| -50 ~ -65 dBm | 🟡 良好 | 信号良好，日常使用无压力 |\n| -65 ~ -75 dBm | 🟠 一般 | 信号一般，可能有延迟 |\n| -75 dBm以下 | 🔴 较差 | 信号弱，建议调整位置 |\n\n#### 信道选择建议\n\n**2.4GHz频段**：\n- 推荐信道：1、6、11（互不干扰）\n- 避免使用：2-5、7-10（信道重叠）\n\n**5GHz频段**：\n- 推荐信道：36、40、44、48、149、153、157、161\n- 干扰较少，适合高速传输\n\n### 💡 设计思路与迭代规划\n\n#### 技术选型原因\n\n- **Python**：跨平台、生态丰富、易于维护\n- **Textual**：现代化TUI框架，支持CSS样式、动画效果\n- **Rich**：美观的终端输出，支持表格、进度条等\n\n#### 后续功能迭代计划\n\n- [ ] 支持更多WiFi网卡驱动\n- [ ] 添加历史数据趋势图\n- [ ] 支持WiFi 6E (6GHz) 分析\n- [ ] 添加网络速度测试功能\n- [ ] 支持导出PDF报告\n\n#### 社区贡献方向\n\n- 欢迎提交Issue和PR\n- 支持更多语言的本地化\n- 改进扫描算法和准确性\n\n### 📦 打包与部署指南\n\n#### 构建安装包\n\n```bash\n# 安装构建依赖\npip install build twine\n\n# 构建\nmake build\n\n# 上传到PyPI\nmake upload\n```\n\n#### 本地开发\n\n```bash\n# 安装开发依赖\nmake install-dev\n\n# 运行测试\nmake test\n\n# 代码格式化\nmake format\n\n# 代码检查\nmake lint\n```\n\n### 🤝 贡献指南\n\n1. Fork 本仓库\n2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)\n3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)\n4. 推送到分支 (`git push origin feature/AmazingFeature`)\n5. 创建 Pull Request\n\n### 📄 开源协议\n\n本项目采用 [MIT](LICENSE) 协议开源。\n\n---\n\n## 繁體中文\n\n### 🎉 專案介紹\n\nWiFiDash 是一款智能WiFi網路診斷與視覺化工具，幫助使用者快速了解周圍的WiFi環境，優化網路配置，提升上網體驗。\n\n**靈感來源**：在日常開發和辦公中，經常遇到WiFi訊號不穩定、頻道壅塞等問題。市面上雖然有一些WiFi分析工具，但要么功能複雜難用，要么需要付費。WiFiDash 旨在提供一個**簡潔、高效、開源**的替代方案。\n\n**自研差異化亮點**：\n- 🎨 美觀的TUI介面，無需瀏覽器即可使用\n- 📊 即時頻道分析和壅塞檢測\n- 💡 智慧優化建議（最佳頻道推薦、安全提醒）\n- 🔧 支援CLI和TUI兩種使用模式\n- 📤 一鍵匯出掃描結果\n\n### ✨ 核心特性\n\n| 特性 | 描述 |\n|------|------|\n| 📶 **網路掃描** | 掃描周圍所有WiFi網路，顯示SSID、訊號強度、加密方式等 |\n| 📊 **頻道分析** | 分析2.4GHz和5GHz頻道使用情況，檢測壅塞 |\n| 💡 **智慧建議** | 自動推薦最佳頻道，檢測安全漏洞 |\n| 🖥️ **互動式TUI** | 基於Textual的美觀終端介面 |\n| ⌨️ **CLI支援** | 支援命令列操作，方便腳本整合 |\n| 📤 **資料匯出** | 支援JSON格式匯出，便於後續分析 |\n| 🔒 **安全檢測** | 自動識別開放網路、WEP等不安全加密 |\n\n### 🚀 快速開始\n\n#### 環境要求\n\n- Python 3.8+\n- Linux/macOS/Windows\n- 可選：WiFi網卡（用於真實掃描，否則使用演示資料）\n\n#### 安裝\n\n```bash\n# 從PyPI安裝（推薦）\npip install wifidash\n\n# 或從原始碼安裝\ngit clone https://github.com/gitstq/wifidash.git\ncd wifidash\npip install -e .\n```\n\n#### 啟動TUI介面\n\n```bash\nwifidash\n```\n\n#### CLI命令\n\n```bash\n# 掃描WiFi網路\nwifidash scan\n\n# 以JSON格式輸出\nwifidash scan --json\n\n# 匯出到檔案\nwifidash scan --export results.json\n\n# 分析頻道\nwifidash channels\n\n# 取得最佳化建議\nwifidash recommend\n\n# 持續監控模式\nwifidash monitor --interval 5\n```\n\n### 📖 詳細使用指南\n\n#### TUI介面操作\n\n| 快捷鍵 | 功能 |\n|--------|------|\n| `r` | 重新整理掃描 |\n| `a` | 切換自動掃描 |\n| `e` | 匯出資料 |\n| `q` | 退出 |\n| `?` | 顯示幫助 |\n\n#### 訊號強度解讀\n\n| 訊號強度 | 品質 | 說明 |\n|----------|------|------|\n| -30 ~ -50 dBm | 🟢 優秀 | 訊號很強，適合高畫質影片、遊戲 |\n| -50 ~ -65 dBm | 🟡 良好 | 訊號良好，日常使用無壓力 |\n| -65 ~ -75 dBm | 🟠 一般 | 訊號一般，可能有延遲 |\n| -75 dBm以下 | 🔴 較差 | 訊號弱，建議調整位置 |\n\n#### 頻道選擇建議\n\n**2.4GHz頻段**：\n- 推薦頻道：1、6、11（互不干擾）\n- 避免使用：2-5、7-10（頻道重疊）\n\n**5GHz頻段**：\n- 推薦頻道：36、40、44、48、149、153、157、161\n- 干擾較少，適合高速傳輸\n\n### 💡 設計思路與迭代規劃\n\n#### 技術選型原因\n\n- **Python**：跨平台、生態豐富、易於維護\n- **Textual**：現代化TUI框架，支援CSS樣式、動畫效果\n- **Rich**：美觀的終端輸出，支援表格、進度條等\n\n#### 後續功能迭代計劃\n\n- [ ] 支援更多WiFi網卡驅動\n- [ ] 新增歷史資料趨勢圖\n- [ ] 支援WiFi 6E (6GHz) 分析\n- [ ] 新增網路速度測試功能\n- [ ] 支援匯出PDF報告\n\n#### 社群貢獻方向\n\n- 歡迎提交Issue和PR\n- 支援更多語言的在地化\n- 改進掃描演算法和準確性\n\n### 📦 打包與部署指南\n\n#### 構建安裝包\n\n```bash\n# 安裝構建依賴\npip install build twine\n\n# 構建\nmake build\n\n# 上傳到PyPI\nmake upload\n```\n\n#### 本地開發\n\n```bash\n# 安裝開發依賴\nmake install-dev\n\n# 執行測試\nmake test\n\n# 程式碼格式化\nmake format\n\n# 程式碼檢查\nmake lint\n```\n\n### 🤝 貢獻指南\n\n1. Fork 本倉庫\n2. 建立特性分支 (`git checkout -b feature/AmazingFeature`)\n3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)\n4. 推送到分支 (`git push origin feature/AmazingFeature`)\n5. 建立 Pull Request\n\n### 📄 開源協議\n\n本專案採用 [MIT](LICENSE) 協議開源。\n\n---\n\n## English\n\n### 🎉 Project Introduction\n\nWiFiDash is an intelligent WiFi network diagnostics and visualization tool that helps users quickly understand their surrounding WiFi environment, optimize network configuration, and improve their internet experience.\n\n**Inspiration**: In daily development and office work, we often encounter WiFi signal instability and channel congestion issues. While there are some WiFi analysis tools on the market, they are either too complex to use or require payment. WiFiDash aims to provide a **simple, efficient, and open-source** alternative.\n\n**Self-developed Differentiation Highlights**:\n- 🎨 Beautiful TUI interface, no browser required\n- 📊 Real-time channel analysis and congestion detection\n- 💡 Intelligent optimization suggestions (best channel recommendations, security alerts)\n- 🔧 Support for both CLI and TUI modes\n- 📤 One-click export of scan results\n\n### ✨ Core Features\n\n| Feature | Description |\n|---------|-------------|\n| 📶 **Network Scanning** | Scan all surrounding WiFi networks, display SSID, signal strength, encryption, etc. |\n| 📊 **Channel Analysis** | Analyze 2.4GHz and 5GHz channel usage, detect congestion |\n| 💡 **Smart Recommendations** | Automatically recommend best channels, detect security vulnerabilities |\n| 🖥️ **Interactive TUI** | Beautiful terminal interface based on Textual |\n| ⌨️ **CLI Support** | Command-line operations for easy script integration |\n| 📤 **Data Export** | Export in JSON format for further analysis |\n| 🔒 **Security Detection** | Automatically identify open networks, WEP, and other insecure encryption |\n\n### 🚀 Quick Start\n\n#### Requirements\n\n- Python 3.8+\n- Linux/macOS/Windows\n- Optional: WiFi adapter (for real scanning, otherwise uses demo data)\n\n#### Installation\n\n```bash\n# Install from PyPI (recommended)\npip install wifidash\n\n# Or install from source\ngit clone https://github.com/gitstq/wifidash.git\ncd wifidash\npip install -e .\n```\n\n#### Launch TUI\n\n```bash\nwifidash\n```\n\n#### CLI Commands\n\n```bash\n# Scan WiFi networks\nwifidash scan\n\n# Output in JSON format\nwifidash scan --json\n\n# Export to file\nwifidash scan --export results.json\n\n# Analyze channels\nwifidash channels\n\n# Get optimization recommendations\nwifidash recommend\n\n# Continuous monitoring mode\nwifidash monitor --interval 5\n```\n\n### 📖 Detailed Usage Guide\n\n#### TUI Interface Controls\n\n| Shortcut | Function |\n|----------|----------|\n| `r` | Refresh scan |\n| `a` | Toggle auto scan |\n| `e` | Export data |\n| `q` | Quit |\n| `?` | Show help |\n\n#### Signal Strength Interpretation\n\n| Signal Strength | Quality | Description |\n|-----------------|---------|-------------|\n| -30 ~ -50 dBm | 🟢 Excellent | Strong signal, suitable for HD video and gaming |\n| -50 ~ -65 dBm | 🟡 Good | Good signal, no pressure for daily use |\n| -65 ~ -75 dBm | 🟠 Fair | Average signal, may have latency |\n| Below -75 dBm | 🔴 Poor | Weak signal, recommend adjusting position |\n\n#### Channel Selection Recommendations\n\n**2.4GHz Band**:\n- Recommended channels: 1, 6, 11 (non-overlapping)\n- Avoid: 2-5, 7-10 (channel overlap)\n\n**5GHz Band**:\n- Recommended channels: 36, 40, 44, 48, 149, 153, 157, 161\n- Less interference, suitable for high-speed transmission\n\n### 💡 Design Philosophy and Iteration Planning\n\n#### Technology Selection Rationale\n\n- **Python**: Cross-platform, rich ecosystem, easy to maintain\n- **Textual**: Modern TUI framework with CSS styling and animation support\n- **Rich**: Beautiful terminal output with tables, progress bars, etc.\n\n#### Future Feature Iteration Plans\n\n- [ ] Support for more WiFi adapter drivers\n- [ ] Add historical data trend charts\n- [ ] Support WiFi 6E (6GHz) analysis\n- [ ] Add network speed test functionality\n- [ ] Support PDF report export\n\n#### Community Contribution Directions\n\n- Welcome Issues and PRs\n- Support for more language localizations\n- Improve scanning algorithms and accuracy\n\n### 📦 Packaging and Deployment Guide\n\n#### Build Package\n\n```bash\n# Install build dependencies\npip install build twine\n\n# Build\nmake build\n\n# Upload to PyPI\nmake upload\n```\n\n#### Local Development\n\n```bash\n# Install dev dependencies\nmake install-dev\n\n# Run tests\nmake test\n\n# Format code\nmake format\n\n# Lint code\nmake lint\n```\n\n### 🤝 Contributing Guidelines\n\n1. Fork this repository\n2. Create a feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Create a Pull Request\n\n### 📄 License\n\nThis project is open-sourced under the [MIT](LICENSE) License.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made with ❤️ by WiFiDash Team**\n\n[Report Bug](https://github.com/gitstq/wifidash/issues) · [Request Feature](https://github.com/gitstq/wifidash/issues)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fwifidash","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitstq%2Fwifidash","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fwifidash/lists"}