:fireworks: Insanely fast pixelflut client for images and animations written in Rust.
A quick pixelflut (video) client in Rust for use at 34C3, that pwns whole pixelflut panels.
For a high performance pixelflut client and server implementations, see:
PB
with --binary
)Pixelflut a simple image:
# Flut a simple image.
# - To host 127.0.0.1 on port 8080
# - With the image: image.png
# - With 4 painting threads
# - With the size of the screen (default)
pixelpwnr 127.0.0.1:8080 -i image.png -c 4
# Other CLI syntax is also supported
pixelpwnr "127.0.0.1:8080" --image="image.png" -c=4
Pixelflut an animated image:
# Flut an animated image, with multiple frames.
# - To host 127.0.0.1 on port 8080
# - With the images: *.png
# - With 5 frames per second
# - With 4 painting threads
# - With a size of (400, 400)
# - With an offset of (100, 100)
pixelpwnr 127.0.0.1:8080 -i *.png --fps 5 -c 4 -w 400 -h 400 -x 100 -y 100
Use the --help
flag, or see the help section for all available
options.
For installation, Git and Rust cargo are required. Install the latest version of Rust with rustup.
Then, clone and install pixelpwnr
with:
# Clone the project
git clone https://github.com/timvisee/pixelpwnr.git
cd pixelpwnr
# Install pixelpwnr
cargo install -f
# Start using pixelpwnr
pixelpwnr --help
# or run it directly from Cargo
cargo run --release -- --help
Or just build it and invoke the binary directly (Linux/macOS):
# Clone the project
git clone https://github.com/timvisee/pixelpwnr.git
cd pixelpwnr
# Build the project (release version)
cargo build --release
# Start using pixelpwnr
./target/release/pixelpwnr --help
There are many things that affect how quickly pixels can be painted on a
pixelflut server.
Some of them are:
pixelpwnr
is running on.Things that improve painting performance:
-c
flag) as the server, your connection and your
machine allows.-w
, -h
flags).pixelpwnr
instances to push
pixels to the screen.$ pixelpwnr --help
Insanely fast pixelflut client for images and animations
Usage: pixelpwnr [OPTIONS] --image <PATH>... <HOST>
Arguments:
<HOST> The host to pwn "host:port"
Options:
--help Show this help
-i, --image <PATH>... Image path(s)
-w, --width <PIXELS> Draw width [default: screen width]
-h, --height <PIXELS> Draw height [default: screen height]
-x <PIXELS> Draw X offset [default: 0]
-y <PIXELS> Draw Y offset [default: 0]
-c, --count <COUNT> Number of concurrent threads [default: number of CPUs]
-r, --fps <RATE> Frames per second with multiple images [default: 1]
-b, --binary Use binary mode to set pixels (`PB` protocol extension) [default: off]
-f, --flush <ENABLED> Flush socket after each pixel [default: true] [default: true] [possible values: true, false]
-V, --version Print version
This project is released under the GNU GPL-3.0 license. Check out the LICENSE file for more information.