windows-troll 0.1.0

Modular Windows prank library
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89

# windows-troll

A modular Rust library (and CLI) of harmless Windows "troll" pranks. Each
prank is a self-contained module behind its own Cargo feature flag, so you can
build exactly the ones you want.

Windows only.

## Modules

| Feature           | Module                     | What it does                                          |
| ----------------- | -------------------------- | ----------------------------------------------------- |
| `window-hider`    | `modules::window_hider`    | Minimize (hide) and restore windows                   |
| `mouse-teleporter`| `modules::mouse_teleporter`| Move the mouse to chosen or random positions          |
| `window-wobbler`  | `modules::window_wobbler`  | Smoothly sway a window in place (direction + amplitude) |
| `window-party`    | `modules::window_party`    | Scramble your screen into an animated grid party      |

## Building

```sh
# everything (all default features)
cargo build --release

# just one module
cargo build --no-default-features --features window-hider
```

## CLI usage

```sh
# Root help
cargo run -- --help

# Window hider
cargo run -- window-hider list
cargo run -- window-hider hide                     # minimize a random window
cargo run -- window-hider hide --title "Untitled"
cargo run -- window-hider restore <HWND>
cargo run -- window-hider loop --min 10 --max 60   # daemon

# Mouse teleporter
cargo run -- mouse-teleporter resolution
cargo run -- mouse-teleporter teleport <X> <Y>
cargo run -- mouse-teleporter random
cargo run -- mouse-teleporter loop

# Window wobbler
cargo run -- window-wobbler foreground --direction both --min 2 --max 10
cargo run -- window-wobbler random --duration 3 --min 4 --max 12
cargo run -- window-wobbler title "Notepad"

# Window party (screen scramble)
cargo run -- window-party --grid 20 --duration 120
cargo run -- window-party --animation galaxy --cycle 15 --seed 42
```

Run any subcommand with `--help` for its full options. `window-party` supports
`LEFT`/`RIGHT` to switch animations, `Space` to pause, and `Esc` to end early
(disable with `--no-interactive`).

## Using as a library

```rust
use windows_troll::modules::window_wobbler::{wobble_foreground_window, WobbleSettings};

wobble_foreground_window(WobbleSettings::default());
```

## Architecture

```
src/
├── lib.rs            # crate root; exports `desktop` and `modules`
├── desktop.rs        # shared window enumeration (WindowInfo, list_windows)
├── main.rs           # CLI entry: builds the root Command from the registry
├── cli/
│   ├── mod.rs        # CliModule trait + all() registry
│   └── modules/      # per-module CLI implementations (one per module)
└── modules/          # the library modules themselves (clap-free)
    └── window_hider/
        ├── mod.rs
        ├── mouse_teleporter/...
        ├── window_wobbler/...
        └── window_party/
            ├── mod.rs
            ├── capture.rs     # screen capture (BitBlt)
            ├── grid.rs        # grid tile easing
            └── animations.rs  # 18 animation styles
```