Giter Club home page Giter Club logo

mbpfan's Introduction

mbpfan

Build Status

This is an enhanced version of Allan McRae mbpfan

mbpfan is a daemon that uses input from coretemp module and sets the fan speed using the applesmc module. This enhanced version assumes any number of processors and fans (max. 10).

  • It only uses the temperatures from the processors as input.
  • It requires coretemp and applesmc kernel modules to be loaded.
  • It requires root use
  • It daemonizes or stays in foreground
  • Verbose mode for both syslog and stdout
  • Users can configure it using the file /etc/mbpfan.conf

Table Of Contents

Supported GNU/Linux Distributions

We provide scripts to to load mbpfan daemon at system boot for many distros. Please note that the support is provided by volunteers. mbpfan needs tests and bug reports.

Supported distributions:

  • Ubuntu
  • Debian
  • Archlinux
  • Fedora
  • RedHat
  • CentOS
  • Gentoo
  • Alpine
  • Trisquel
  • Solus

Tested Mac Models

See https://github.com/linux-on-mac/mbpfan/wiki/Tested-Mac-Models .

Requirements

Be sure to load the kernel modules applesmc and coretemp.

These modules are often automatically loaded when booting up GNU/Linux on a MacBook. If that is not the case, you should make sure to load them at system startup.

How do I know if applesmc and coretemp are loaded?

In most distributions, you can run the following command:

lsmod | grep -e applesmc -e coretemp

If you see coretemp and applesmc listed, you are all set.

If you do not see coretemp and applesmc listed, you must load them.

This is usually achieved by inserting the following two lines in the file /etc/modules

coretemp
applesmc

Please check the relevant documentation of your GNU/Linux distribution.

Installation

Arch Linux

See mbpfan-git at AUR. Otherwise, please refer to the Generic Instructions.

CRUX Linux

Follow the instructions on jolupalabs REPO for installation.

Debian

On Debian 10 or later install via:

sudo apt-get install mbpfan

Fedora

On Fedora 30 or later:

sudo dnf install mbpfan

Gentoo

Install the mbpfan package with:

sudo emerge -av app-laptop/mbpfan

Solus

On Solus, install the package with:

sudo eopkg install mbpfan

then enable the service.

Ubuntu

On Ubuntu 18.04 or later install via:

sudo apt-get install mbpfan

Generic Install Instructions (All Other Operating Systems)

Compile with

make

Install with

sudo make install

It copies mbpfan to /usr/sbin, mbpfan.conf to /etc (and overwrites existing files), README.md to /usr/share/doc/mbpfan, and mbpfan.8.gz to /usr/share/man/man8

If you would like to compile with Clang instead of GCC, simply set your system's default compiler to be Clang. Tested with Clang 3.8 and 3.9. Tested with Clang 4.0 along with llvm-lld (The LLVM Linker).

Run The Tests (Optional)

Users may run the tests after building the program. Please run the following command from within the source directory.

sudo make tests

Note that this only works on MacBook and not desktop computers due to different environment expectations.

Run Instructions

If not installed, run with

sudo bin/mbpfan

If installed, manually run with

sudo mbpfan

If installed and using the init file, run with (Ubuntu example)

sudo service mbpfan start

Starting at boot

Ubuntu

For systemd based init systems (Ubuntu 16.04+), see the systemd section below.

For upstart based init systems (Ubuntu before 16.04), an example upstart job has been provided. For using it, execute:

sudo cp mbpfan.upstart /etc/init/mbpfan.conf
sudo start mbpfan

Debian An init file suitable for /lib/lsb/init-functions (Debian) is located in the main folder of the source files, called mbpfan.init.debian Rename it to mbpfan, give it execution permissions (chmod +x mbpfan) and move it to /etc/init.d Then, add it to the default runlevels with (as root):

sudo update-rc.d mbpfan defaults

Redhat, CentOS, Fedora An init file suitable for /etc/rc.d/init.d/functions (RHEL/CentOS & Fedora) is also located at the same place, this file is called mbpfan.init.redhat. Also rename it to mbpfan, give it execution permissions and move it to /etc/init.d To add the script to the default runlevels, run the following as root:

chkconfig --level 2345 mbpfan on && chkconfig --level 016 mbpfan off

Gentoo

To automatically run mbpfan at boot, run as root:

rc-update add mbpfan default

systemd As a special bonus, a service file for systemd is also included. To use it, execute the following (as root):

sudo cp mbpfan.service /etc/systemd/system/
sudo systemctl enable mbpfan.service
sudo systemctl daemon-reload
sudo systemctl start mbpfan.service

dinit A dinit service definition is also included. To use it, execute the following:

sudo cp mbpfan.dinit /etc/dinit.d/mbpfan
sudo dinitctl enable mbpfan
sudo dinitctl start mbpfan

Usage

Usage: ./mbpfan OPTION(S)

-h Show the help screen
-f Run in foreground
-v Be (a lot) verbose

References

License

GNU General Public License version 3

Credits

This Project Is Based On:

This Project uses following library:

mbpfan's People

Contributors

dgraziotin avatar gaul avatar rmusial avatar cerial avatar oliviertilmans avatar rvega avatar rmmm avatar magnusstubman avatar yamakaky avatar codutti avatar ahyangyi avatar akatrevorjay avatar lyessaadi avatar krutonium avatar gktrk avatar ayyess avatar x-s avatar mikaelbjoern avatar localscope avatar jolupa avatar heimoshuiyu avatar wezm avatar tiikeri avatar tburette avatar pjvds avatar evjan avatar camengkristensson avatar nbfritch avatar marji avatar larutan avatar

Stargazers

Lucas F Aguiar avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.