mirror of
https://github.com/kiddin9/op-packages.git
synced 2026-11-16 21:43:33 +08:00
171 lines
6.9 KiB
Markdown
171 lines
6.9 KiB
Markdown
<!-- markdownlint-configure-file {
|
|
"MD013": {
|
|
"code_blocks": false,
|
|
"tables": false,
|
|
"line_length":200
|
|
},
|
|
"MD033": false,
|
|
"MD041": false
|
|
} -->
|
|
|
|
[license]: /LICENSE
|
|
[license-badge]: https://img.shields.io/github/license/jerrykuku/luci-theme-argon?style=flat-square&a=1
|
|
[prs]: https://github.com/jerrykuku/luci-theme-argon/pulls
|
|
[prs-badge]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square
|
|
[issues]: https://github.com/jerrykuku/luci-theme-argon/issues/new
|
|
[issues-badge]: https://img.shields.io/badge/Issues-welcome-brightgreen.svg?style=flat-square
|
|
[release]: https://github.com/jerrykuku/luci-theme-argon/releases
|
|
[release-badge]: https://img.shields.io/github/v/release/jerrykuku/luci-theme-argon?style=flat-square
|
|
[download]: https://github.com/jerrykuku/luci-theme-argon/releases
|
|
[download-badge]: https://img.shields.io/github/downloads/jerrykuku/luci-theme-argon/total?style=flat-square
|
|
[contact]: https://t.me/jerryk6
|
|
[contact-badge]: https://img.shields.io/badge/Contact-telegram-blue?style=flat-square
|
|
[en-us-link]: /README.md
|
|
[zh-cn-link]: /README_ZH.md
|
|
[en-us-release-log]: /RELEASE.md
|
|
[zh-cn-release-log]: /RELEASE_ZH.md
|
|
[config-link]: https://github.com/jerrykuku/luci-app-argon-config/releases
|
|
[official]: https://github.com/openwrt/openwrt
|
|
[immortalwrt]: https://github.com/immortalwrt/immortalwrt
|
|
|
|
<div align="center">
|
|
<img src="https://raw.githubusercontent.com/jerrykuku/staff/master/argon_title4.svg">
|
|
|
|
# A brand new OpenWrt LuCI theme
|
|
|
|
Argon is **a clean and tidy OpenWrt LuCI theme** that allows<br/>
|
|
users to customize their login interface with images or videos.
|
|
It also supports automatic and manual switching between light and dark modes.
|
|
|
|
[![license][license-badge]][license]
|
|
[![prs][prs-badge]][prs]
|
|
[![issues][issues-badge]][issues]
|
|
[![release][release-badge]][release]
|
|
[![download][download-badge]][download]
|
|
[![contact][contact-badge]][contact]
|
|
|
|
**English** |
|
|
[简体中文][zh-cn-link]
|
|
|
|
[Key Features](#key-features) •
|
|
[Compatibility](#compatibility) •
|
|
[Version History](#version-history) •
|
|
[Getting started](#getting-started) •
|
|
[Screenshots](#screenshots) •
|
|
[Contributors](#contributors) •
|
|
[Credits](#credits)
|
|
|
|
<img src="https://raw.githubusercontent.com/jerrykuku/staff/master/argon2.gif">
|
|
</div>
|
|
|
|
## Key Features
|
|
|
|
- Clean and modern Argon-style interface design.
|
|
- Fully adapted for both desktop and mobile displays.
|
|
- Supports automatic or manual switching between light and dark modes.
|
|
- Supports custom theme colors, along with adjustable blur and transparency effects.
|
|
- The login page supports local images, videos, and online wallpapers as backgrounds.
|
|
- Works with [luci-app-argon-config][config-link] for a more complete theme configuration experience.
|
|
|
|
Choose **Classic sidebar** (default) or **Centered card** under **System → Argon Config → Login page style**. Both layouts use the same wallpaper, color and authentication settings. Update both the theme and configuration plugin to use the selector; missing or unsupported `login_style` values fall back to `classic`.
|
|
|
|
Unsplash wallpapers require an Unsplash API access key. The current `luci-app-argon-config` UI does not expose this setting; after choosing Unsplash, set it through UCI:
|
|
|
|
```sh
|
|
uci set 'argon.@global[0].use_api_key=YOUR_UNSPLASH_ACCESS_KEY'
|
|
uci commit argon
|
|
```
|
|
|
|
Without a key, the login page uses a local background. Bing and Wallhaven wallpaper options are unaffected.
|
|
|
|
## Compatibility
|
|
|
|
Only the `master` branch is maintained now.
|
|
Support is focused on modern LuCI environments based on [Official OpenWrt][official] and [ImmortalWrt][immortalwrt].
|
|
|
|
## Version History
|
|
|
|
The latest version is v2.4.8 [Click here][en-us-release-log] to view the full version history record.
|
|
|
|
## Getting started
|
|
|
|
### Build from source
|
|
|
|
```bash
|
|
cd openwrt/package
|
|
git clone https://github.com/jerrykuku/luci-theme-argon.git
|
|
make menuconfig #choose LUCI->Theme->Luci-theme-argon
|
|
make -j1 V=s
|
|
```
|
|
|
|
### Choose the package format
|
|
|
|
Choose the format used by the firmware's native package manager. The presence of an `apk` command alone does not identify it:
|
|
|
|
| Firmware package manager | Release assets | Install command |
|
|
| --- | --- | --- |
|
|
| `opkg` (including OpenWrt 23.05, 24.10, and GL.iNet firmware based on these versions) | `.ipk` | `opkg install` |
|
|
| OpenWrt / ImmortalWrt using APK v3 natively (`apk-tools 3.x`) | `.apk` | `apk add --allow-untrusted` |
|
|
|
|
The APK assets use **APK v3 format**, which `apk-tools 2.x` (including `2.14.0`) cannot read. `--allow-untrusted` only bypasses signature trust checks; it does not add format support. `apk` cannot install IPK files either.
|
|
|
|
For the GL.iNet / OpenWrt 23.05 environment in [#705](https://github.com/jerrykuku/luci-theme-argon/issues/705), download IPK files and install them with the firmware's existing `opkg`. There is no need to replace the system package manager.
|
|
|
|
Download `luci-theme-argon`, `luci-app-argon-config`, and any required `luci-i18n-argon-config-<language>` packages from [Releases][release]. Select the same format for all packages and use the actual asset filenames; do not construct version suffixes or rename file extensions.
|
|
|
|
Put the downloaded files in one empty directory, keeping only one version of each package, then run the appropriate commands from that directory.
|
|
|
|
### Install release packages (`ipk`)
|
|
|
|
```bash
|
|
opkg update
|
|
opkg install ./luci-theme-argon_*.ipk ./luci-app-argon-config_*.ipk
|
|
```
|
|
|
|
If you also downloaded language packages in the same format, install them with:
|
|
|
|
```bash
|
|
opkg install ./luci-i18n-argon-config-*.ipk
|
|
```
|
|
|
|
### Install release packages (`apk`)
|
|
|
|
Use this only on firmware that natively uses `apk-tools 3.x`. Check the version with `apk --version`.
|
|
|
|
```bash
|
|
apk update
|
|
apk add --allow-untrusted ./luci-theme-argon-*.apk ./luci-app-argon-config-*.apk
|
|
```
|
|
|
|
If you also downloaded language packages in the same format, install them with:
|
|
|
|
```bash
|
|
apk add --allow-untrusted ./luci-i18n-argon-config-*.apk
|
|
```
|
|
|
|
If you encounter `IO ERROR`, first use `ls -l ./*.apk` to check that the files exist, their names are correct, and the downloads are complete, then check `apk --version`. Do not force installation to bypass format or dependency errors.
|
|
|
|
|
|
## Screenshots
|
|
|
|

|
|

|
|
|
|
## Contributors
|
|
|
|
<a href="https://github.com/jerrykuku/luci-theme-argon/graphs/contributors">
|
|
<img src="https://contrib.rocks/image?repo=jerrykuku/luci-theme-argon&v=2" />
|
|
</a>
|
|
|
|
Made with [contrib.rocks](https://contrib.rocks).
|
|
|
|
## Related Projects
|
|
|
|
- [luci-app-argon-config](https://github.com/jerrykuku/luci-app-argon-config): Configuration plugin for the Argon theme
|
|
- [openwrt-package](https://github.com/jerrykuku/openwrt-package): My OpenWrt package collection
|
|
- [CasaOS](https://github.com/IceWhaleTech/CasaOS): A simple, elegant open-source personal cloud system and my current primary project
|
|
|
|
## Credits
|
|
|
|
[luci-theme-material](https://github.com/LuttyYang/luci-theme-material/)
|