username/rf-mapper
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: update CLI commands to use python -m rf_mapper

Browse Source 
- Replace rf-mapper with python -m rf_mapper throughout docs
- Add note about activating venv first
- Updated: CLAUDE.md, PROJECT.md, USAGE.md, CHEATSHEET.md, HOME_ASSISTANT.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
User
2026-02-01 17:38:44 +01:00
parent 322c53d513
commit 91536860ad
5 changed files with 72 additions and 58 deletions
Download Patch File Download Diff File Expand all files Collapse all files

55
docs/CHEATSHEET.md
View File

@@ -6,21 +6,26 @@ Quick reference for RF Mapper commands and configuration.
## CLI Commands
All commands require activating the virtual environment first:
```bash
source venv/bin/activate
```
| Command | Description |
|---------|-------------|
| `rf-mapper` | Interactive scan mode |
| `rf-mapper scan` | Run scan with defaults |
| `rf-mapper scan -l kitchen` | Scan with location label |
| `rf-mapper scan --no-bt` | WiFi only |
| `rf-mapper scan --no-wifi` | Bluetooth only |
| `rf-mapper visualize` | ASCII radar display |
| `rf-mapper analyze` | RF environment analysis |
| `rf-mapper list` | List saved scans |
| `rf-mapper start` | Start web server (background) |
| `rf-mapper stop` | Stop web server |
| `rf-mapper restart` | Restart web server |
| `rf-mapper status` | Check if server is running |
| `rf-mapper config` | Show configuration |
| `python -m rf_mapper` | Interactive scan mode |
| `python -m rf_mapper scan` | Run scan with defaults |
| `python -m rf_mapper scan -l kitchen` | Scan with location label |
| `python -m rf_mapper scan --no-bt` | WiFi only |
| `python -m rf_mapper scan --no-wifi` | Bluetooth only |
| `python -m rf_mapper visualize` | ASCII radar display |
| `python -m rf_mapper analyze` | RF environment analysis |
| `python -m rf_mapper list` | List saved scans |
| `python -m rf_mapper start` | Start web server (background) |
| `python -m rf_mapper stop` | Stop web server |
| `python -m rf_mapper restart` | Restart web server |
| `python -m rf_mapper status` | Check if server is running |
| `python -m rf_mapper config` | Show configuration |
---
@@ -28,18 +33,18 @@ Quick reference for RF Mapper commands and configuration.
```bash
# Lifecycle
rf-mapper start # Start (background daemon)
rf-mapper stop # Stop
rf-mapper restart # Restart
rf-mapper status # Check if running
python -m rf_mapper start # Start (background daemon)
python -m rf_mapper stop # Stop
python -m rf_mapper restart # Restart
python -m rf_mapper status # Check if running
# Start options
rf-mapper start -f # Foreground mode
rf-mapper start -H 127.0.0.1 # Bind to localhost only
rf-mapper start -p 8080 # Custom port
rf-mapper start --debug # Debug mode (requires -f)
rf-mapper start --profile-requests # Per-request profiling
rf-mapper start --log-requests # Request logging
python -m rf_mapper start -f # Foreground mode
python -m rf_mapper start -H 127.0.0.1 # Bind to localhost only
python -m rf_mapper start -p 8080 # Custom port
python -m rf_mapper start --debug # Debug mode (requires -f)
python -m rf_mapper start --profile-requests # Per-request profiling
python -m rf_mapper start --log-requests # Request logging
```
---
@@ -48,10 +53,10 @@ rf-mapper start --log-requests # Request logging
```bash
# Show current config
rf-mapper config
python -m rf_mapper config
# Set GPS coordinates
rf-mapper config --set-gps 50.8585 4.3978 --save
python -m rf_mapper config --set-gps 50.8585 4.3978 --save
```
---

2
docs/HOME_ASSISTANT.md
View File

@@ -258,7 +258,7 @@ template:
1. **Enable integration**: Set `home_assistant.enabled: true` in config.yaml
2. **Add HA automations**: Copy webhook automations to HA
3. **Restart RF Mapper**: `rf-mapper restart`
3. **Restart RF Mapper**: `source venv/bin/activate && python -m rf_mapper restart`
4. **Run scan**: Trigger BT scan in RF Mapper web UI
5. **Check HA**: Verify `device_tracker.rf_*` entities appear
6. **Test new device**: Clear device from DB, re-scan, verify notification