## Contents
* [Changelog](https://github.com/webmin/authentic-theme/blob/master/CHANGELOG.md)
* [Download![](https://authentic-theme.com/media/icons/download-23x14.png)](https://github.com/webmin/authentic-theme/releases)
* [About](#about)
* [FAQ](#faq)
* [Development](#development)
* [Donate![](https://authentic-theme.com/media/icons/heart-23x15.png)](https://github.com/webmin/authentic-theme#donate)
* [License](#license)

## About
**Authentic Theme** is modern, ultrafast single-page application for [Webmin/](https://github.com/webmin/webmin)[Usermin](https://github.com/webmin/usermin) that is made with _love_. Managing servers, operating systems and applications has never been so easy.

<p align="center">
  <a href="https://webmin.com/screenshots/#gh-light-mode-only" target="_blank">
    <img width="1440" alt="Dashboard screenshot" src="https://user-images.githubusercontent.com/4426533/218264253-c08fb45a-8d75-44bf-93b3-37a2ecae3d20.png">
  </a>
  <a href="https://webmin.com/screenshots/#gh-dark-mode-only" target="_blank">
    <img width="1440" alt="Dashboard screenshot" src="https://user-images.githubusercontent.com/4426533/218265232-31140aa6-ada1-4019-bd75-04240aeabc83.png">
  </a>
</p>

### Features
* Configurable theme options using _Webmin_/_Usermin_ UI, with ability to embed user logos and custom styles
* Hotkeys and favorites for quicker access
* Notification slider for instant access to pushed system messages
* Extended support for _File Manager_ and _ConfigServer Security & Firewall_ modules
* Code highlight when viewing and editing files
* Drop-down interface for both _Terminal_ and _Command Shell_ module

### Requirements
* Webmin _2.020+_ (required), Usermin _1.861+_ (optional), Virtualmin _7.5+_ (optional), Cloudmin _9.7+_ (optional)

## FAQ

### How to update _Authentic_ Theme manually?
Go to theme configuration and hit _Force update theme_ button to install either _stable_ or _development_ version of the theme.

### How to update _Authentic_ Theme automatically?
The theme has built-in feature to notify administrative users to install updates. To enable this feature, turn on _Check for Authentic Theme updates_ in theme configuration.

### How to show beta updates notifications for the theme?
Go to theme configuration folder under Webmin, create/find _config_ file, open it and add/change the value from _0_ to _1_ for _beta_updates_ option.

### How do I customize the theme?
Theme has configurable options. There, as well, you can upload custom _logos_ and code custom _styles.css_, _scripts.js_ and _scripts.pl_.

### How do I execute shell command using search field?
Type `!` in search, followed by your command. Example: `!ls /root`. It's required to have _Terminal_ or _Command Shell_ module available.

## Extended support for bundled/third-party modules

### _File Manager_
Theme has great support for this module, by adding numerous must-have features, which enables you to use _File Manager_ just as normal desktop browser.

### _ConfigServer Security & Firewall_
Theme only re-renders this module and adds support for code highlight, when editing files manually.

## Development
### Lead developer
* [Ilia Rostovtsev](https://github.com/iliajie)

### Contributions

#### Code
* [Jamie Cameron](https://github.com/jcameron)
* [Joe Cooper](https://github.com/swelljoe)

#### Translations
* [Pierre Wozniak](https://github.com/pwozniak89) (French)
* [Maicol Battistini](https://github.com/maicol07) (Italian)
* [Richard van Laak](https://github.com/Rvanlaak) (Dutch)
* [Michał Pawlik](https://github.com/majk-p) (Polish)
* [Kay Marquardt](https://github.com/gnadelwartz), [Michael Keck](https://github.com/mkkeck) (German)
* [Silviu-Ionut Radu](https://github.com/sealview) (Romanian)
* [David Canalias](https://github.com/diathesaron) (Catalan)
* [Sopor](https://github.com/Sopor-) (Swedish)
* [7stars](https://github.com/7starsone) (Spanish, French, Portuguese)
* [miyorineko](https://github.com/miyorineko), [dreista](https://github.com/Dreista) (Chinese)
* [jlndk](https://github.com/jlndk) (Danish)
* [stuchy3](https://github.com/stuchy3) (Czech)
* [Samsul Ma'arif](https://github.com/samsulmaarif) (Indonesian)
* [Adalen Vladi](https://github.com/adalenv) (Albanian)
* Stein-Aksel Basma, [Kjetil Elde](https://github.com/w00p) (Norwegian)
* [Kosugikun](https://github.com/kosugikun) (Japanese)

## Donate
 It takes countless hours to develop and maintain this project. Donations show appreciation. Your donation would help me to pay my bills and _excite future development_.

<a href="https://www.paypal.com/donate/?hosted_button_id=NM3ZRVZTQV39E">![](https://user-images.githubusercontent.com/4426533/226430276-086c5d38-597c-46b0-85d9-4b431e571086.png)</a>

### Bitcoin (BTC)
*bc1q3tzz9a5nkrppcmc6tallvlpvavyfh6hljdtucy*

### Ethereum (ETH)
*0x044CF9EEE22388c59d2813126bF11513C158b010*

### Litecoin (LTC)
*ltc1qwgqxupqnpk7ttug9x7r84xmuf9ecck90scn8yp*

### The Open Network (TON)
*EQBUGLcioULfX2N3F-JIr5KTtJ3LKi1pSC20HWqzec7xDL7H*

## License

**Authentic Theme** is released under the [MIT License](https://github.com/webmin/authentic-theme/blob/master/LICENSE).