Modern, cross-platform computer activity monitoring with multiple implementation options
Selfspy is a comprehensive activity monitoring suite that tracks keyboard input, mouse activity, window changes, and terminal commands across multiple platforms. Choose from Python, Rust, or Phoenix implementations based on your needs.
| Implementation | Best For | Key Features |
|---|---|---|
| Python | General use, scripting, research | Original implementation, mature ecosystem |
| Rust | Performance, system integration | Native GUI, low resource usage |
| Elixir/Phoenix | Web dashboard, real-time analytics | LiveView interface, multi-user |
| Objective-C/macOS | macOS desktop integration | Native widgets, system notifications |
| Nim | Compiled performance, Python-like syntax | Memory-safe, fast compilation |
| Crystal | Ruby-like syntax, native performance | Type-safe, excellent concurrency |
| Zig | Maximum performance, systems programming | Memory-safe C replacement, minimal overhead |
# Python (recommended for most users)
curl -sSL https://install.selfspy.dev/python | bash
# Or clone and choose your implementation
git clone https://github.com/selfspy/selfspy3.git
cd selfspy3
# Quick Python setup
cd python && python3 install.py# Start monitoring (from Python directory)
cd python && selfspy start
# View enhanced statistics
selfviz enhanced
# Terminal analytics
selfterminal commands --days 7
# Check permissions (macOS)
selfspy check-permissionsselfspy/
├── python/ # 🐍 Python Implementation
│ ├── src/selfspy/ # Main Python package
│ ├── tests/ # Python tests
│ ├── desktop-app/ # macOS desktop widgets
│ └── README.md # Python-specific guide
│
├── rust/ # 🦀 Rust Implementation
│ ├── selfspy-core/ # Core library
│ ├── selfspy-gui/ # GUI application
│ ├── selfspy-cli/ # Command line tools
│ └── README.md # Rust-specific guide
│
├── elixir/ # 🔥 Elixir/Phoenix Implementation
│ ├── lib/ # Elixir source code
│ ├── assets/ # Frontend assets
│ ├── priv/ # Migrations and static files
│ └── README.md # Elixir-specific guide
│
├── objective-c/ # 🍎 Objective-C/macOS Implementation
│ ├── SelfspyWidgets.xcodeproj/ # Xcode project
│ ├── SelfspyWidgets/ # Source code
│ ├── Scripts/ # Build scripts
│ └── README.md # Objective-C guide
│
├── nim/ # ⚡ Nim Implementation
│ ├── src/ # Nim source code
│ ├── selfspy.nimble # Package configuration
│ └── README.md # Nim-specific guide
│
├── crystal/ # 💎 Crystal Implementation
│ ├── src/ # Crystal source code
│ ├── shard.yml # Shard configuration
│ └── README.md # Crystal-specific guide
│
├── zig/ # ⚡ Zig Implementation
│ ├── src/ # Zig source code
│ ├── build.zig # Build configuration
│ └── README.md # Zig-specific guide
│
├── docs/ # 📚 Documentation
│ ├── installation/ # Installation guides
│ ├── user-guides/ # User documentation
│ └── development/ # Developer guides
│
├── shared/ # 🔧 Shared Resources
│ ├── scripts/ # Development scripts
│ ├── schemas/ # Database schemas
│ └── configs/ # Configuration templates
│
└── tools/ # 🛠️ Development Tools
├── docker/ # Container configurations
└── ci/ # CI/CD configurations
- Keystroke Tracking - Encrypted text capture with activity analysis
- Mouse Activity - Click events, movement patterns, and usage statistics
- Window Management - Active application tracking and window metadata
- Terminal Analytics - Command history with git integration and project detection
- Encryption by Default - All sensitive data encrypted at rest
- Local Storage Only - No cloud transmission, complete data ownership
- Configurable Exclusions - Exclude sensitive applications and windows
- Permission Management - Granular control over what gets monitored
- Command Line - Full-featured CLI for all operations
- Web Dashboard - Real-time Phoenix LiveView interface
- Native GUI - Cross-platform Rust application with charts
- Desktop Widgets - macOS notification center integration
# Setup development environment for all implementations
./shared/scripts/setup-dev-env-new.sh
# Use the development helper
./dev python uv run selfspy start # Python
./dev rust cargo run --bin selfspy-gui # Rust GUI
./dev elixir mix phx.server # Phoenix web
./dev objective-c make all # macOS widgets
./dev nim nimble run selfspy start # Nim compiled
./dev crystal shards run selfspy start # Crystal compiled
./dev zig zig build run -- start # Zig maximum performance
./dev test # All tests
./dev build # Build everythingThe ./dev script provides easy access to all implementations:
./dev [language] [command]
# Examples:
./dev python uv run selfspy start
./dev rust cargo build --release
./dev elixir mix phx.server
./dev objective-c make all
./dev nim nimble build
./dev crystal shards build --release
./dev zig zig build -Doptimize=ReleaseFast
./dev test # Run all tests
./dev build # Build all implementations- Installation Guides - Platform-specific setup
- User Guides - How to use Selfspy effectively
- Development Docs - Contributing and architecture
- API Reference - Programming interfaces
- Choose the implementation you want to work on
- Read the language-specific README in that directory
- Follow the development setup instructions
- See Contributing Guide for details
MIT License - see LICENSE for details.
- Documentation: docs/
- Issues: GitHub Issues
- Discussions: GitHub Discussions
Built with ❤️ by the Selfspy community