NBFC-SERVICE(1)

📦
version 0.5.4 · 2 versions
, in nixpkgs unstable

💖 NAME 💖

okay so this page is all about nbfc_service — the Notebook FanControl service ✨ like, the actual daemon that talks to your laptop's fan controller so your machine doesn't melt while you're gaming. bestie behavior tbh 🫶

🌸 DESCRIPTION 🌸

NoteBook FanControl service 💅

that's the whole vibe. it runs, it manages your fans, it's the main character of your cooling setup 👑

✨ SYNOPSIS ✨

nbfc_service [OPTIONS]

🎀 OPTIONS 🎀

  • -h, --help — prints the help message and dips out. classic ✨
  • --version — shows the program's version number then exits. iykyk 🦋
  • -r, --read-only — starts up in read-only mode. no writing, just looking 👀 respect the boundaries fr
  • -f, --fork — after it successfully starts, it switches the process to the background. so it slays quietly in the back 💀
  • -d, --debug — turns on tracing of reads and writes to the embedded controller. super useful when you're like "why is this not working" 😭
  • -c, --config-file CONFIG — use a different config file instead of the default /nix/store/48mhb6ci6w735jxaz60mhn63p4ccn956-nbfc-linux-0.5.4/etc/nbfc/nbfc.json. go off, customize 🧚
  • -e, --embedded-controller {ec_sys, acpi_ec, dev_port, dummy} — picks which implementation gets used to access the embedded controller. the choices are, and i quote:
    • ec_sys: use the ec_sys kernel module.
    • acpi_ec: use the acpi_ec kernel module.
    • dev_port: access the embedded controller via /dev/port.
    • dummy: don't touch the embedded controller at all. zero contact, purely vibes 🙈

🦋 FILES 🦋

  • /nix/store/48mhb6ci6w735jxaz60mhn63p4ccn956-nbfc-linux-0.5.4/etc/nbfc/nbfc.json — the main configuration file for nbfc_service. peep nbfc_service.json(5) for all the details, bestie 📖
  • /run/nbfc_service.pid — the file holding the PID of the currently running nbfc_service. its little name tag 🏷️
  • /run/nbfc_service.socket — the socket file of nbfc_service. that's how everyone talks to it 💬
  • /nix/store/48mhb6ci6w735jxaz60mhn63p4ccn956-nbfc-linux-0.5.4/share/nbfc/configs/*.json — configuration files for the various notebook models. again, see nbfc_service.json(5) for more 🌈
  • /nix/store/48mhb6ci6w735jxaz60mhn63p4ccn956-nbfc-linux-0.5.4/share/nbfc/model_support.json — the model support database. this file maps notebook model names to configuration files, like a little matchmaker 💜
  • /var/lib/nbfc/configs/*.json — configuration files downloaded from the internet. files in this directory take precedence over the ones in /nix/store/48mhb6ci6w735jxaz60mhn63p4ccn956-nbfc-linux-0.5.4/share/nbfc/configs. so downloaded beats bundled, no cap 👑
  • /var/lib/nbfc/model_support.json — the model support database downloaded from the internet. both /var/lib/nbfc/model_support.json and /nix/store/48mhb6ci6w735jxaz60mhn63p4ccn956-nbfc-linux-0.5.4/share/nbfc/model_support.json are taken into account. it's giving teamwork 🤝
  • /var/lib/nbfc/state.json — the state file of nbfc_service. this holds the current fan speeds. literally its diary of how fast things are spinning 🍓

💅 EXIT STATUS 💅

  • 0 — everything fine. we love a happy ending 💖
  • 1 — generic error. shrug 😭
  • 2 — command-line error. you typed something weird bestie
  • 3 — initialization error. couldn't even get started 💀
  • 5 — fatal error (memory allocation failure). the worst one, RIP 🪦

🐛 BUGS 🐛

found a bug? report it to https://github.com/nbfc-linux/nbfc-linux — the maintainers want to hear it fr fr 🫶

🧚 AUTHOR 🧚

Benjamin Abendroth (braph93@gmx.de) — an icon, honestly 👑

⭐ SEE ALSO ⭐

nbfc(1), nbfc_service.json(5), ec_probe(1), fancontrol(1)

and that's the whole page!! 🌸 this was Notebook FanControl 0.5.4, dated APRIL 2026 — go keep your fans cool bestie, mwah 💋💜

📦 where this page comes from