lcdproc(1)

🌸 lcdproc(1) — the LCDproc suite's lil status-info bestie 🌸

okay so bestie, welcome to the lcdproc manual page 💖 it lives in the LCDproc suite and it's literally the moment you've been waiting for.

---

✨ NAME ✨

lcdproc — system status information client 🫶

---

✨ SYNOPSIS ✨

lcdproc [-hfv] [-c config] [-s host] [-p port] [-e delay] [screen ...]

---

✨ DESCRIPTION ✨

so lcdproc is the client in the LCDproc suite, and its whole vibe is displaying info about your local system's status on an LCD that's hooked up to an LCDd server daemon. 👑

and here's the iconic part: because of the client-server architecture, it literally does not matter whether the LCDd daemon is running on the local machine or on a remote system. no cap. 🌈

most settings of lcdproc are configured through its configuration file /etc/lcdproc.conf, and some of them can be overridden using command line options. ✨

bestie, before running lcdproc you should carefully read through that file and modify the settings therein according to your needs. like, carefully. it's giving "read the docs first" energy for a reason. 💅

when compiled appropriately, some aspects of lcdproc can even be configured at run time using a menu on the LCD. menu on the LCD?? main character behavior fr fr. 🎀

currently, only Linux, the BSD variants FreeBSD, NetBSD, OpenBSD and Darwin as well as Solaris are supported, but not all features may be available on all platforms. 💀

---

✨ OPTIONS ✨

lcdproc understands these command line options, and yes we're doing all of them:

• -c config — use a configuration file other than /etc/LCDd.conf
• -s host — connect to the LCDd server on host, instead to the one listed in the Server parameter in the config file's [lcdproc] section. if not given here and not specified in the config file, or if the default config file does not exist, it defaults to 'localhost.
• -p port — use port port when connecting to the LCDd server on host. this option overrides the Port parameter in the config file's [lcdproc] section. without a default config file or when not set in the config file, it defaults to the LCDproc port 13666. 🔥
• -f — run in the foreground, overriding the Foreground parameter in the config file's [lcdproc] section. the default, if not in the config file or without a config file, is to daemonize lcdproc as it is intended to display the system information in the background. 🙈
• -e delay — sleep delay in 100ths of seconds between updating screens in an update cycle. this option overrides the Delay parameter in the config file's [lcdproc] section. when not given and not in the config file, it defaults to 0.
• -h — show help screen. 🫶
• -v — print the version of lcdproc and exit. ⭐

---

🦋 the screens 🦋

screen can be one of the following:

• C — CPU — show detailed CPU usage
• P — SMP-CPU — CPU usage overview: one line per CPU, especially useful on SMP systems.
• G — CPUGraph — CPU histogram
• L — Load — Load histogram
• M — Memory — memory & swap usage
• S — ProcSize — memory usage of 5 biggest processes
• D — Disk — filling level of the mounted file systems
• I — Iface — network interface usage
• B — Battery — battery status
• T — TimeDate — time & date information
• O — OldTime — old time screen
• U — Uptime — uptime screen
• K — BigClock — big clock
• N — MiniClock — minimal clock
• A — About — credits page

on the command line you may either use the short or the long screen name. in the config file, the long names are used as section labels to configure the screens further. iykyk 💜

you may also prefix the screen names with an exclamation mark '!' to disable a screen that was activated in the config file instead of activating a disabled one. plot twist energy. 😭

---

✨ EXAMPLES ✨

lcdproc C M D '!L'

with the command line specified above, lcdproc loads the default configuration file, connects to the LCDd server specified therein and then displays the following screens in addition to those activated in the configuration file on the LCD:

• detailed CPU Usage
• Memory & swap usage
• filling level of the mounted file systems

the

• Load histogram

screen is disabled and therefore not shown in the display. 🚫

the quotes are not part of lcdproc's command line syntax; they are required to disable special interpretation of the exclamation mark by the shell. so like, keep them. the shell is dramatic. 💅

---

✨ FILES ✨

• /etc/lcdproc.conf, lcdproc's default configuration file

---

✨ SEE ALSO ✨

LCDd(8), lcdproc-config(5)

---

✨ AUTHOR ✨

many people have contributed to LCDproc. see the CREDITS file for more details. 👑

all questions should be sent to the lcdproc mailing list. the mailing list, and the newest version of LCDproc, should be available from here:

http://www.lcdproc.org/

---

✨ LEGAL STUFF ✨

LCDproc is released as "WorksForMe-Ware". in other words, it is free, kinda neat, and we don't guarantee that it will do anything in particular on any machine except the ones it was developed on. 💀

it is technically released under the GNU GPL license (you should have received the file, "COPYING", with LCDproc) (also, look on http://www.fsf.org/ for more information), so you can distribute and use it for free — but you must make the source code freely available to anyone who wants it. 🫶

for any sort of real legal information, read the GNU GPL (GNU General Public License). it's worth reading. fr fr. 📖

---

and that's the whole page bestie — brought to you by the LCDproc squad, dated 24 March 2011, and it slayed. 💖✨🎀🦋🌸