Add clap‑based CLI with subcommands (gpu, battery, power, status), verbose flag, and detailed options such as rtd3, use_nvidia_current, etc. - New Features - New CLI entry point with complete subcommand hierarchy - Verbose logging support - Granular command options for GPU, Battery, Power, Status - Enhancements - Replace placeholder hello world with proper logging initialization - Modularize command implementations into dedicated modules
lapctl
lapctl is an upcoming command-line utility written in Rust for managing laptop hardware features on Linux.
It aims to provide a simple and unified interface for controlling hybrid GPU modes, battery charging limits, and other laptop power features directly from the terminal.
Planned Features
-
Switch GPU modes on hybrid graphics laptops
- Integrated GPU
- Hybrid mode
- NVIDIA GPU
-
Set and manage battery charging limits
-
View laptop hardware and power status
-
Lightweight and fast CLI interface
-
Designed for Linux systems with hybrid GPUs (Optimus)
Project Status
Work in progress
This project is currently in early development. Features, commands may change as development progresses.
Goals
- Provide a simple CLI interface for laptop hardware management
- Support hybrid GPU laptops (Intel + NVIDIA / AMD + NVIDIA)
- Offer battery health features like charge limit control
- Be lightweight, fast, and easy to use
Example CLI (Planned)
lapctl gpu integrated
lapctl gpu hybrid
lapctl gpu nvidia
lapctl battery limit 80
lapctl battery status
lapctl status
Built With
- Rust
- Modern Linux system interfaces
Project Structure
lapctl
│
├── Cargo.toml
├── README.md
├── LICENSE
├── .gitignore
│
├── src/
│ ├── main.rs
│ ├── cli.rs
│ │
│ ├── commands/
│ │ ├── mod.rs
│ │ ├── gpu.rs
│ │ ├── battery.rs
│ │ ├── power.rs
│ │ └── status.rs
│ │
│ ├── hardware/
│ │ ├── mod.rs
│ │ ├── gpu.rs
│ │ └── battery.rs
│ │
│ └── utils/
│ └── system.rs
Roadmap
- CLI structure
- GPU mode switching
- Battery charge limit management
- Hardware status command
- Configuration support
Contributing
Contributions, ideas, and feature suggestions are welcome. More contribution guidelines will be added once the project reaches its first stable milestone.
License
This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).
You are free to use, modify, and distribute this software under the terms of the license. For full details, see the LICENSE file in this repository.
⭐ If you find this project interesting, consider starring the repository to follow its progress.