wallswitch 0.64.1

randomly selects wallpapers for multiple monitors
Documentation 
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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

#!/usr/bin/env python3
"""
Python script to automate the systemd user service and timer setup
for the wallswitch application with a customizable rotation interval.
"""

import argparse
import subprocess
import sys
from pathlib import Path

def main():
    # Setup CLI arguments
    parser = argparse.ArgumentParser(
        description="Configure systemd user service and timer for wallswitch."
    )
    parser.add_argument(
        "-s", "--seconds",
        type=int,
        default=300,
        help="Interval in seconds between wallpaper rotations (default: 300 / 5 minutes)."
    )
    args = parser.parse_args()

    # Minimum limit check to avoid systemd flooding (5 seconds)
    if args.seconds < 5:
        print("Error: The interval must be at least 5 seconds.", file=sys.stderr)
        sys.exit(1)

    # Format description time dynamically for readability
    if args.seconds % 60 == 0:
        desc_time = f"{args.seconds // 60} minutes"
    else:
        desc_time = f"{args.seconds} seconds"

    print(f"Initializing systemd timer configuration (Interval: {desc_time})...")

    home = Path.home()
    cargo_bin = home / ".cargo" / "bin" / "wallswitch"

    if not cargo_bin.exists():
        print(f"Warning: Binary not found at {cargo_bin}")
        print("Please ensure you have run 'cargo install --path=.' before triggering this script.")
    
    systemd_user_dir = home / ".config" / "systemd" / "user"
    service_path = systemd_user_dir / "wallswitch.service"
    timer_path = systemd_user_dir / "wallswitch.timer"

    systemd_user_dir.mkdir(parents=True, exist_ok=True)

    # Systemd Service file
    service_content = f"""[Unit]
Description=Wallswitch Wallpaper Rotator
After=graphical-session.target

[Service]
Type=oneshot
ExecStart={cargo_bin} --once
"""

    # Systemd Timer file with custom interval
    timer_content = f"""[Unit]
Description=Run Wallswitch every {desc_time}

[Timer]
OnActiveSec=0sec
OnUnitActiveSec={args.seconds}sec
AccuracySec=1s

[Install]
WantedBy=timers.target
"""

    try:
        # Write files
        service_path.write_text(service_content, encoding="utf-8")
        print(f"Service file written to: {service_path}")

        timer_path.write_text(timer_content, encoding="utf-8")
        print(f"Timer file written to: {timer_path}")

        # Reload daemon and enable timer
        print("Reloading systemd user daemon...")
        subprocess.run(["systemctl", "--user", "daemon-reload"], check=True)

        print("Enabling and starting wallswitch.timer...")
        subprocess.run(
            ["systemctl", "--user", "enable", "--now", "wallswitch.timer"],
            check=True
        )

        print("\nChecking systemd timer status:")
        subprocess.run(
            ["systemctl", "--user", "status", "wallswitch.timer"],
            check=False
        )

        print(f"\nSetup completed successfully! Wallswitch will run every {desc_time}.")

    except subprocess.CalledProcessError as err:
        print(f"\nError executing systemd commands: {err}", file=sys.stderr)
        sys.exit(1)
    except OSError as err:
        print(f"\nFile system I/O error: {err}", file=sys.stderr)
        sys.exit(1)

if __name__ == "__main__":
    main()