xvidtune(1)

✨ xvidtune(1) ✨

General Commands Manual 💖 okay bestie, this is the manual page for xvidtune, the tool that lets you fiddle with your video modes like a pro 💅

🌸 NAME 🌸

xvidtune — video mode tuner for Xorg 🎀

🦋 SYNOPSIS 🦋

xvidtune [ -show | -prev | -next | -unlock | -timeout sec ] [
-toolkitoption ... ]

💜 DESCRIPTION 💜

okay so xvidtune is a client interface to the X server video mode extension (XFree86-VidModeExtension) and it is literally so iconic ✨

when you give it one of the non-toolkit options, it becomes a command line interface where you can either print or switch the video mode. no buttons, just vibes 🧚

without any options (or with only toolkit options) it pulls up a whole bunch of buttons and sliders so you can adjust existing video modes interactively 🔥 it will also print the settings in a format that's suitable for putting into an xorg.conf file, so you can keep your glow-up 💅

⚠️ normally the Xorg X servers only let you make changes with the XFree86-VidModeExtension from clients connected through a local connection type. so no sneaking in from the outside, periodt 🙈

🌈 note: you can restore the original mode settings by pressing the R key!! this is your lifeline if the screen ever becomes unreadable, so remember it fr fr 😭

🎀 The Buttons 🎀

the buttons are giving main character energy, here's the lineup:

👈 Left, Right, Up, Down 👉

Adjust the video mode so that the display moves in the appropriate direction. ✨

📏 Wider, Narrower, Shorter, Taller 📏

Adjust the video mode so that the display size gets altered appropriately. ✨

🚪 Quit

Exit the program. bye bye 👋

✅ Apply

Adjust the current video mode to match the selected settings. slay 💖

🤖 Auto

Cause the Up/Down/Right/Left, Wider/Narrower/Shorter/Taller, Restore, and the special S3 buttons to be applied immediately. this button can be toggled, so you can switch it on and off whenever you want 🫶

🧪 Test

Temporarily switch to the selected settings. just a test run, no commitment 🙈

⏪ Restore

Return the settings to their original values. the undo button of your dreams 🌸

🔍 Fetch

Query the server for its current settings. let's see what the server is working with 👀

🖨️ Show

Print the currently selected settings to stdout in xorg.conf "Modeline" format. the primary selection is similarly set too 💜

⏭️ Next

Switch the Xserver to the next video mode. 🦋

⏮️ Prev

Switch the Xserver to the previous video mode. 🦋

🧚 S3 Extras 🧚

for some S3-based cards (964 and 968) the following are also available, iykyk 🔥

🔄 InvertVCLK

Change the VCLK invert/non-invert state. 🌈

🫧 EarlySC

Change the Early SC state. this one affects screen wrapping, so keep an eye on it 👀

⏱️ BlankDelay1 and BlankDelay2

Set the blank delay values. these also affect screen wrapping. acceptable values are in the range 0-7. you can bump the values up or down with the + and - buttons, or by pressing the + or - keys in the text field 🎀

for S3-864/868 based cards, InvertVCLK and BlankDelay1 may be useful 💅 for S3 Trio32/Trio64 cards, only InvertVCLK is available, sorry bestie 🥺

🚫 at the moment there are no default settings available for these chips in the video mode extension, so this feature is disabled in xvidtune. it can be enabled by setting any of the optional S3 commands in the screen section of xorg.conf, e.g. using:

blank_delay "∗" 0

✨ OPTIONS ✨

xvidtune accepts the standard X Toolkit command line options, plus the following:

• -show — prints the current settings to stdout in xorg.conf "Modeline" format and then exits. quick and clean 💖
• -prev — switches the Xserver to the previous video mode. ⏮️
• -next — switches the Xserver to the next video mode. ⏭️
• -unlock — okay so normally xvidtune turns off switching video modes via hot-keys while it's running. if the program didn't exit cleanly and those keys are still disabled, rerun it with this option to re-enable the mode switching key combos 🔓🔥
• -timeout sec — sets the testmode timeout in seconds. ⏳

🫶 SEE ALSO 🫶

xrandr(1), Xorg(1), xorg.conf(5). go read these if you want more tea 🍵

👑 AUTHORS 👑

Kaleb S. Keithley, X Consortium. the legends who came before us 🌟

Additions and modifications by Jon Tombs, David Dawes, and Joe Moss. more queens who made it better 💜

💀 BUGS 💀

X Error handling, i.e. when the server does not allow xvidtune clients to write new modes, could be better. honestly this one is a little embarrassing for the X server, not you 🙈

---

X Version 11, xvidtune 1.0.4, xvidtune(1) — that's the whole tea, bestie 🧚💖 now go tune those modes and slay the display 💅✨