hyprdvd - GitLite

KO | EN

gitlite — search

#python #react #ai #typescript #golang #android #linux #docker #nodejs #macos #awesome #kubernetes #security #openai

hyprdvd

(★ 113)

Bounce your terminal like a DVD screen

File Explorer

Download Latest Version (.zip)

- - __init__.py
  - hyprDVD.py
  - hyprDVDManager.py
  - main.py
  - screensaver.py
  - settings.py
  - utils.py
.gitignore
CHANGELOG.md
flake.lock
flake.nix
LICENSE
pyproject.toml
README.md

# Installation Guide

1. Get the code

git clone https://github.com/nevimmu/hyprdvd

Downloads the entire project code from GitHub to your computer.

cd hyprdvd

Moves into the project folder you just downloaded.

2. Official Install Script

Easy Recommended

Prerequisites

pipx Installs Python-based CLI tools into isolated environments.

pipx install .

Installs the CLI tool into an isolated environment via pipx.

✅ After installing, open a new terminal and run the program's version command (e.g. --version) to confirm it worked.

Pulled directly from this repo's README.

3. Python

Easy

Prerequisites

Git Needed to download the project code from GitHub.
Python 3 On Windows, be sure to check 'Add Python to PATH' during installation.

pip install .

Installs the package published on PyPI directly — no need to clone the source.

python <실행할 파일명>.py # README에서 정확한 실행 파일명을 확인하세요

Runs the Python script (or module).

✅ If it runs without errors and prints output in the terminal, it worked.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# HyprDVD

A tiny utility for hyprland that makes windows titled "DVD" float and bounce around like the classic DVD logo — now with a screensaver mode that temporarily animates all windows on the current workspace and restores them when the cursor moves.

## Highlights

- Animates windows titled "DVD" by making them floating and moving them with collision detection.
- Screensaver mode: captures the current workspace windows, makes them float and animate, and restores their original state when the cursor moves.
- Restore behavior attempts to faithfully restore original size/position and then tiles windows.

## Installation

### From the AUR
```bash
yay -S hyprdvd
```

### For NixOS with home-manager

Add the input to your `flake.nix`:
```nix
{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    home-manager = {
      url = "github:nix-community/home-manager";
      inputs.nixpkgs.follows = "nixpkgs";
    };
    hyprdvd = {
      url = "github:nevimmu/hyprdvd";
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };

outputs = { nixpkgs, home-manager, hyprdvd, ... }: {
    homeConfigurations.youruser = home-manager.lib.homeManagerConfiguration {
      pkgs = nixpkgs.legacyPackages.x86_64-linux;
      modules = [
        hyprdvd.homeManagerModules.default
        ./home.nix
      ];
    };
  };
}
```

Then in your `home.nix`:
```nix
{ config, pkgs, ... }:

{
  services.hyprdvd = {
    enable = true;
    autoStart = true;  # Automatically start with Hyprland
  };
}
```

All configuration is done via command-line arguments. See the Usage section below for available options.

### From source
```bash
git clone https://github.com/nevimmu/hyprdvd
cd hyprdvd

# Install into your environment (pipx recommended)
pipx install .
```

## Usage

Basic usage runs the event-driven mode that listens to Hyprland events and animates any newly opened window whose title is exactly `DVD`:

```bash
hyprdvd
kitty --title DVD
```

Screensaver mode — animate all windows on the current workspace until the cursor moves. You can add it to your idle daemon (ex: hypridle)

```bash
hyprdvd --screensaver
# or
hyprdvd -s
```

You can customize the size of bouncing windows using the `--size` flag with the width and height you want

```bash
# Make windows 200x150 pixels
hyprdvd --size 200x150
```
## Multi-monitor screensaver

`hyprdvd` can animate *all visible workspaces* (i.e., one per monitor) without switching focus or warping the cursor. It restores windows cleanly when asked to stop.

### New flags

- `--workspaces <id,id,...>`  
  Animate only the specified workspace IDs. If omitted, all *visible* workspaces are used (one per monitor).

- `--exit-on {pointer,signal}`  
  Choose how the screensaver exits:
  - `pointer` (default): stop when the cursor moves.
  - `signal`: ignore pointer motion; exit only on `SIGINT` (e.g., via your idle daemon).

### Examples

Run on all visible workspaces, ignore pointer until signaled:
```bash
hyprdvd --screensaver --size 200x150 --exit-on signal
# later:
pkill -INT hyprdvd