# linux-dash-darkmode

**Repository Path**: MusicScore/linux-dash-darkmode

## Basic Information

- **Project Name**: linux-dash-darkmode
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-18
- **Last Updated**: 2025-04-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<h1 align="center">
  <a href="https://afaqurk.github.io/linux-dash">
    <img src="https://athe.moe/rsc/img/v2.0-logo-dark.png"/>
  </a>
</h1>

<p align="center">
<small>Dark mode version with toggle</small><br/> 
<small>This is still under development so bugs might pop up.</small><br/>
</p>
<p align="center">
<sub>v2.0</sub><br/> <small>A simple & low-overhead web dashboard for linux
systems</small>
</p>
</p>

<p align="center">
  <small>
    <a href="https://afaqurk.github.io/linux-dash">Demo</a> &nbsp;|&nbsp;
    <a href="https://github.com/afaqurk/linux-dash/wiki">
      Docs
    </a>
  </small>
</p>

<p align="center">
  <a href="https://gitter.im/afaqurk/linux-dash">
    <img
      src="https://badges.gitter.im/gitterHQ/gitter.png"
      alt="linux-dash Gitter chat">
  </a>
</p>

<br/>

## Dark mode support

This fork adds a toggle to the navbar so you can switch to dark mode or light
mode.

It's still in an early stage and needs some cleaning.

## Features

- **Small** ----- Under 400KB on disk _(with .git removed)!_
- **Simple** ---- A minimalist, beautiful dashboard
- **Easy** ------ Drop-in installation
- **Versatile** -- Choose your stack from Node.js, Go, Python, PHP

## Installation

### Step 1

```sh
## 1. clone the repo
git clone --depth 1 https://github.com/afaqurk/linux-dash.git

## 2. go to the cloned directory
cd linux-dash/app/server

```

OR, if you prefer to download manually:

```sh
## 1. Download the .zip
curl -LOk https://github.com/afaqurk/linux-dash/archive/master.zip && unzip master.zip

## 2. navigate to downloaded & unzipped dir
cd linux-dash-master/app/server

```

### Step 2

See instructions for preferred server linux-dash server _(all included)_:

- [Node.js](#if-using-nodejs) _(recommended)_
- [Go](#if-using-go)
- [Python](#if-using-python)
- [PHP](#if-using-php)

#### If Using Node.js

```sh
## install dependencies
npm install --production

## start linux-dash (on port 80 by default; may require sudo)
## You may change this with the `LINUX_DASH_SERVER_PORT` environment variable (eg. `LINUX_DASH_SERVER_PORT=8080 node server`)
## or provide a --port flag to the command below
## Additionally, the server will listen on every network interface (`0.0.0.0`).
## You may change this with the `LINUX_DASH_SERVER_HOST` environment variable (eg. `LINUX_DASH_SERVER_HOST=127.0.0.1 node server`)
## or provide a --host flag to the command below
node index.js

```

#### If Using Go

```sh
## start the server (on port 80 by default; may require sudo)
go run index.go
```

To build a binary, run `go build && ./server -h`. See
[@tehbilly](https://github.com/sergeifilippov)'s notes
[here](https://github.com/afaqurk/linux-dash/pull/281) for binary usage options

#### If Using Python

```sh
# Start the server (on port 80 by default; may require sudo).
python index.py
```

#### If Using PHP

1. Make sure you have the `exec`, `shell_exec`, and `escapeshellarg` functions
   enabled
2. Point your web server to `app/` directory under `linux-dash`
3. Restart your web server (Apache, nginx, etc.)

- For PHP + Apache setup follow the
  [Digital Ocean tutorial](https://www.digitalocean.com/community/tutorials/how-to-install-linux-dash-on-ubuntu-14-04).
- For help with nginx setup, see
  [this gist](https://gist.github.com/sergeifilippov/8909839) by
  [@sergeifilippov](https://github.com/sergeifilippov).

## Support

For general help, please use the
[Gitter chat room](https://gitter.im/afaqurk/linux-dash).

## Security

**It is strongly recommended** that all linux-dash installations be protected
via a security measure of your choice.

Linux Dash does not provide any security or authentication features.