Document Title: CPUWIN User Guide
Version: 1.0
Publication Date: December 21, 2025
Document Owner: CPUWIN Development Team
Target Audience: End users, system administrators, developers
Language Support: English, Russian, Chinese
| Version | Date | Description | Author |
|---|---|---|---|
| 1.0 | 2025-12-21 | Initial release with ISO/IEC/IEEE 26514 compliance | CPUWIN Team |
This user guide provides comprehensive instructions for installing, configuring, and using CPUWIN, a real-time CPU monitoring application for macOS.
This document covers:
- Installation and initial configuration of CPUWIN
- Basic and advanced usage procedures
- Process monitoring and management features
- Troubleshooting common issues
- Safe uninstallation procedures
This document does not cover:
- Internal software architecture (see developer documentation)
- API development
- Third-party integration
Primary Audience: macOS users who need to monitor system performance and manage processes.
Prerequisites:
- Basic computer literacy
- Familiarity with macOS interface
- Administrative privileges for installation
- macOS 12.0 or later
Skill Level: Beginner to Intermediate
CPUWIN is a status bar application that provides real-time CPU monitoring and process management capabilities. The application runs invisibly in the background, displaying CPU usage in the menu bar and providing detailed process information through an interactive menu system.
End User Scenario:
- Monitor system performance during intensive tasks
- Identify resource-hungry applications
- Terminate unresponsive processes safely
System Administrator Scenario:
- Monitor server performance
- Manage background processes
- Troubleshoot system performance issues
- Platform: macOS 12.0 or later
- System Resources: Minimal (typically < 10MB RAM, < 1% CPU)
- Network: Local system monitoring only
- Security: Requires system permissions for process monitoring
- Operating System: macOS 12.0 or later
- Processor: Any Intel or Apple Silicon Mac
- Memory: 512MB RAM minimum, 1GB recommended
- Storage: 50MB free disk space
- Permissions: Administrative access for installation
Procedure: Install CPUWIN
Purpose: Install and configure CPUWIN for first-time use.
Preconditions:
- Administrative privileges on the macOS system
- Internet connection for repository cloning
- Swift development tools installed (optional, for source builds)
Steps:
-
Clone the repository:
git clone https://github.com/yourusername/cpuwin.git cd cpuwin -
Build the application:
swift build -c release
-
Launch CPUWIN:
./cpuwin_profiling
Post-conditions:
- CPUWIN appears in the menu bar as a CPU percentage
- Application is ready for monitoring operations
Result: CPUWIN is installed and operational.
No additional configuration is required. The application uses default settings optimized for most use cases.
Purpose: View real-time CPU usage and system performance metrics.
Preconditions:
- CPUWIN is running and visible in the menu bar
- System is operational
Steps:
- Locate CPUWIN in the menu bar (shows current CPU percentage)
- Click the CPUWIN icon to open the monitoring menu
- Review CPU Usage in the top section of the menu
- Scroll through process lists to view detailed information
Result: Current system performance data is displayed.
Purpose: View process details and safely terminate problematic processes.
Preconditions:
- CPUWIN is running
- Administrative privileges (for process termination)
Steps:
- Open CPUWIN menu from the menu bar
- Locate the target process in the process lists
- Right-click the process name to open context menu
- Select "Information" to view detailed process data
- For termination, select "Terminate (SIGTERM)" or "Force Kill (SIGKILL)" as appropriate
Result: Process is terminated or detailed information is displayed.
Purpose: Manually update process monitoring data.
Preconditions:
- CPUWIN is running
Steps:
- Open CPUWIN menu from the menu bar
- Press ⌘R or select "Refresh" from the menu
Result: Process data is updated with current system state.
Issue: CPUWIN does not appear in menu bar after launch Symptoms: Application starts but no menu bar icon visible Resolution:
- Check System Settings > General > Login Items
- Ensure CPUWIN is not blocked by security software
- Restart the application
Issue: Process termination fails Symptoms: "Permission denied" or process remains running Resolution:
- Ensure you have administrative privileges
- Try "Force Kill (SIGKILL -9)" for unresponsive processes
- Check if process is protected by the system
Issue: High CPU usage reported by CPUWIN itself Symptoms: CPUWIN shows elevated CPU usage Resolution:
- This is normal during active monitoring
- CPU usage should return to normal when menu is closed
- Consider adjusting update intervals if needed
Issue: Application fails to start Symptoms: Error messages during launch Resolution:
- Verify macOS version compatibility (12.0+)
- Check system permissions for process monitoring
- Ensure no conflicting monitoring software is running
"Permission denied for process monitoring"
- Cause: Insufficient system permissions
- Resolution: Grant necessary permissions in System Settings > Privacy & Security
"Unable to terminate process"
- Cause: Process protected by system or insufficient privileges
- Resolution: Use administrator account or contact system administrator
- GitHub Issues: Report bugs and request features
- Documentation: This user guide
- Community: Check existing issues for similar problems
Uninstallation should be performed when:
- CPUWIN is no longer needed
- System cleanup is required
- Reinstallation is planned
Procedure: Remove CPUWIN
Purpose: Completely remove CPUWIN from the system.
Preconditions:
- Administrative privileges
- CPUWIN is not currently running
Steps:
- Terminate CPUWIN if running (⌘Q or force quit)
- Navigate to the installation directory:
cd /path/to/cpuwin - Remove build artifacts:
rm -rf .build/
- Remove source code (optional):
cd .. rm -rf cpuwin/ - Check for running processes:
pgrep -f cpuwin
- Force terminate any remaining processes (if found):
pkill -9 -f cpuwin
Post-conditions:
- CPUWIN is completely removed from the system
- No residual processes or files remain
Data Backup: No user data is stored by CPUWIN, so no backup is required.
Result: CPUWIN is successfully uninstalled.
CPU (Central Processing Unit): The primary processor of a computer system that executes instructions.
PID (Process ID): A unique numerical identifier assigned to each running process.
SIGTERM: A Unix signal that requests a process to terminate gracefully.
SIGKILL: A Unix signal that forces immediate process termination without cleanup.
Process Tree: A hierarchical structure showing parent-child relationships between processes.
Status Bar: The area at the top of the macOS screen showing system information and application icons.
| Shortcut | Function |
|---|---|
| ⌘R | Refresh process data |
| ⌘Q | Quit CPUWIN |
A
- Administrative privileges: Installation, Process Management
- CPU monitoring: Concept of Operations, Procedures
C
- Configuration: Installation and Configuration
- CPU usage: Monitoring, Troubleshooting
I
- Installation: Installation and Configuration
- Issues: Troubleshooting
P
- Permissions: Installation, Troubleshooting
- Process management: Procedures, Troubleshooting
- Process termination: Procedures
S
- System requirements: Installation and Configuration
- Support: Troubleshooting
T
- Termination: Procedures, Troubleshooting
- Troubleshooting: Troubleshooting
U
- Uninstallation: Uninstallation
- Usage: Procedures
Это руководство пользователя содержит подробные инструкции по установке, настройке и использованию CPUWIN - приложения для мониторинга CPU в реальном времени для macOS.
Документ охватывает:
- Установку и первоначальную настройку CPUWIN
- Основные и расширенные процедуры использования
- Функции мониторинга и управления процессами
- Устранение распространенных проблем
- Безопасные процедуры удаления
Основная аудитория: Пользователи macOS, которым необходимо отслеживать производительность системы и управлять процессами.
Предварительные требования:
- Базовая компьютерная грамотность
- Знакомство с интерфейсом macOS
- Административные привилегии для установки
- macOS 12.0 или новее
CPUWIN - это приложение строки состояния, предоставляющее возможности мониторинга CPU и управления процессами в реальном времени. Приложение работает в фоновом режиме, отображая использование CPU в строке меню и предоставляя подробную информацию о процессах через интерактивную систему меню.
- Операционная система: macOS 12.0 или новее
- Процессор: Любой Mac с Intel или Apple Silicon
- Память: Минимум 512MB RAM, рекомендуется 1GB
- Хранение: 50MB свободного места на диске
- Разрешения: Административный доступ для установки
Назначение: Просмотр использования CPU и метрик производительности системы в реальном времени.
Предварительные условия:
- CPUWIN запущен и виден в строке меню
- Система работает
Проблема: CPUWIN не появляется в строке меню после запуска Симптомы: Приложение запускается, но значок в строке меню не виден Решение:
- Проверьте Системные настройки > Общие > Элементы входа
- Убедитесь, что CPUWIN не блокируется ПО безопасности
- Перезапустите приложение
Назначение: Полностью удалить CPUWIN из системы.
Предварительные условия:
- Административные привилегии
- CPUWIN не запущен
Шаги: [Аналогично английской версии]
本用户指南提供了安装、配置和使用 CPUWIN（macOS 实时 CPU 监控应用程序）的全面说明。
本文档涵盖：
- CPUWIN 的安装和初始配置
- 基本和高级使用程序
- 进程监控和管理功能
- 常见问题故障排除
- 安全卸载程序
CPUWIN 是一个状态栏应用程序，提供实时 CPU 监控和进程管理功能。该应用程序在后台运行，在菜单栏中显示 CPU 使用率，并通过交互式菜单系统提供详细的进程信息。
- 操作系统：macOS 12.0 或更高版本
- 处理器：任何 Intel 或 Apple Silicon Mac
- 内存：最小 512MB RAM，推荐 1GB
- 存储：50MB 可用磁盘空间
- 权限：安装需要管理员访问权限
目的：查看实时 CPU 使用率和系统性能指标。
问题：启动后 CPUWIN 不出现在菜单栏中 症状：应用程序启动但菜单栏中没有图标 解决方案：
- 检查系统设置 > 通用 > 登录项
- 确保 CPUWIN 未被安全软件阻止
- 重新启动应用程序
目的：从系统中完全移除 CPUWIN。
Contributions are welcome! Please feel free to submit pull requests, report issues, or suggest new features.
欢迎贡献！请随时提交拉取请求、报告问题或建议新功能。
This project is licensed under the MIT License - see the LICENSE file for details.
本项目采用 MIT 许可证 - 有关详细信息，请参阅 LICENSE 文件。
Built with ❤️ using Swift on macOS
使用 Swift 在 macOS 上用 ❤️ 构建