BERRYC(1)

💅 BERRYC(1) 💅

okay so bestie, welcome to the berryc page — yes, the manual is literally called BERRYC(1), and yes we're gonna get into all of it. she's a client. she's for berry. she's the whole vibe. 🫶

✨ NAME ✨

berryc — the client for the berry window manager. that's it. that's the whole name. iconic behavior honestly.

🌸 SYNOPSIS 🌸

berryc [-hv] command [args...]

that's the shape of it, bestie: you, the flags, a command, and whatever args that command wants. no cap. 🎀

🦋 DESCRIPTION 🦋

so basically berryc is a simple little command-line client that sends events to the berry window manager. that's her whole job. she's the messenger. she shows up, she delivers the message, she leaves. main character energy but make it a socket. 💅

👑 COMMANDS 👑

this is the good part. this is the part. every single one of these is a whole mood, so let's go down the list together, no skipping, we don't do that here 💖

• window_move x y — shift the current window by the given x/y coordinates. little nudge. wee scoot. ✨
• window_move_absolute x y — move the current window to the absolute x/y coordinates. no "relative to where it was," just be here now. 📍
• window_resize w h — shrink or grow the current window by the given w/h arguments. chunky or smol, your call. 🍓
• window_resize_absolute w h — resize the current window to the absolute w/h arguments. she's gonna be that size, periodt. 📐
• window_raise — raises the current window to the top of the stack. get her up there, she's the moment. ⬆️
• window_monocle — monocles the current window (yes the curent one, iykyk), and it respects the values of TOP_GAP. respectful king. 🧐
• window_close — closes the current window, which in turn terminates the associated process. polite little exit. bye bestie 👋
• window_kill — kills the current window, forcefully terminating the associated process. not polite. nuclear. 💀
• window_center — centers the current window. she's on the 50-yard line. balanced. symmetrical. slay. 🎯
• window_below — toggles "Always Below" on the current window, so it can't rise to the top when activated. she's a background girlie now, and she stays there. 🙈
• switch_workspace i — switch to the given workspace i: every window on the new workspace shows up, every window not on it hides. full scene change. 🌈
• send_to_workspace i — sends the current window to the workspace i you specify, but does not switch workspaces. she travels, you stay put. ✈️
• fullscreen — toggle the fullscreen status of the active window. big mode: engaged. 🖥️
• fullscreen_state — toggle the fullscreen status of the active window but don't change the size. it's a vibe, not a resize. 😌
• snap_left — move and resize the current window to fill the left half of the screen. respects TOP_GAP. left girlies rise 🫶
• snap_right — move and resize the current window to fill the right half of the screen. respects TOP_GAP. right girlies also rise 🫶
• cardinal_focus 1, 2, 3, 4 — switch focus to the nearest window in the specified direction. pick a number, get a direction. 🧭
• cycle_focus — switch focus to the next window in the list. round and round we go 🔄
• pointer_focus — focus the window underneath the pointer. whatever your cursor is hovering over, that's the one. 🖱️
• focus_color XXXXXX — set the color of the outer border for the currently focused window. hex code moment ✨
• unfocus_color XXXXXX — set the color of the outer border for all the windows that are not currently focused. the supporting cast 💜
• inner_focus_color XXXXXX — set the color of the inner border for the currently focused window. inner beauty, literally 🎀
• text_focus_color XXXXXX — set the color of the title bar text for the focused window. ~typography era~ 🖋️
• text_unfocus_color XXXXXX — set the color of the title bar text for all the unfocused windows. equal treatment, less spotlight 🩰
• inner_unfocus_color XXXXXX — set the color of the inner border for all windows not currently focused. yes there's an inner border for those too, keep up 💅
• border_width w — set the width of the outer border in pixels. chunky borders are a personality trait, ngl 🔥
• inner_border_width w — set the width of the inner border in pixels. the little ring inside. 🍩
• title_height h — set the height of the title bar in pixels. give that bar some room to breathe ⭐
• save_monitor i j — associate the *i*th workspace with the *j*th monitor. match made in heaven, arranged by you 💞
• smart_place true/false — place newly created windows in unoccupied regions of the screen. otherwise? new clients go in the top left corner of the active workspace. that's the trade-off, bestie, pick your fighter 🧠
• draw_text true/false — determine whether or not to draw text in window title bars. words or no words, that's the question 📝
• set_font font_name — set the name of the font to use (e.g. set_font dina-9). font choice is so personal, go off 🎨
• json_status true/false — determine whether or not BERRY_WINDOW_STATUS reports state in JSON format or plain text. yes that's a real environment variable, yes she eats 🔥
• name_desktop i d_name — name the ith desktop d_name. it's used with _NET_DESKTOP_NAMES. give your desktops cute names, i'm begging 🏷️
• [manage|unmanage] [Dialog|Toolbar|Menu|Splash|Utility] — manage, or unmanage, windows of type Dialog, Toolbar, Menu, Splash, or Utility. by default, only Toolbars and Splashes are not managed. know your defaults, know yourself 🌟
• edge_gap top bottom left right — set the edge padding around the screen, and you must include all the params. all four, no shortcuts, no "i'll add the rest later" 🚧
• decorate_new true/false — determine whether new windows are decorated by default. bows on or bows off 🎀
• focus_button 1-5 — determine the button used to focus windows on click, if focus_on_click is enabled. conditional queen 🖲️
• move_button 1-5 — determine the button used to move windows using the mouse. drag era 🖐️
• move_mask mod1/mod2/mod3/mod4/mod5 — determine the key mask used to move windows using the mouse. hold a key, then move. combo move ⌨️
• resize_button 1-5 — determine the button used to resize windows using the mouse. squish squish 🫧
• resize_mask mod1/mod2/mod3/mod4/mod5 — determine the key mask used to resize windows using the mouse. same deal, resize flavour 🎛️
• pointer_interval n — set the minimum interval for processing motion events to n. it's set to a default value of 0. useful for input lag on high refresh rate screens. if you experience input lag on high refresh rate screens, try a value around 15. noted, screenshotting, saving for later 📸
• quit — stop the program. that's it. that's the whole description. she said "stop the program." 💀
• edge_lock true/false — bound windows to the edges of the monitor. can't escape. can't slide off. she's contained 🧲
• toggle_decorations — toggle decorations for the currently focused client. bows on, bows off, bows on 🎀
• focus_follows_pointer true/false — focus the window underneath the pointer. your cursor is the focus, she just follows 🐾
• focus_on_click true/false — focus the window on click. click and it's hers. easy 👆

real talk bestie, every single command above is listed exactly as berry expects it — don't get creative with the spelling, don't merge two commands into one, don't add args that aren't there. she's simple, she's specific, she's not taking notes. 🫶

🧚 sign-off 🧚

that's the whole page, bestie!! this one's from March 2020, and it lives up there under the BERRYC(1) header like the little legend she is — so like, when you're citing it in a group chat, that's the vibe. go forth, move windows, respect the TOP_GAP, and remember: only Toolbars and Splashes are unmanaged by default. periodt. 💖✨🎀