Skip to content

TheWisker/Shikai

Repository files navigation

Shikai

Modern lightdm webkit2 theme

Index

Description []

This is a sleek lightdm webkit2 theme that focuses on it's looks with performance in mind.

Features []

The theme features:

  • Draggable windows!
  • Multi-monitor support!
  • Multi-language support!
  • Custom time and date formats!
  • Graphical on-theme behaviour configuration!
  • Graphical on-theme styles configuration!
  • Saving configurations as sub-themes!
  • Sleek animations and on-hover effects!
  • Background shuffle on background click!
  • Idle login window auto-hiding at 60s of inactivity!
  • Custom backgrounds configured via web-greeter.yml!
  • Custom user images configured via a .face image on user home folders!

Live Demo []

  • Demo password: password

https://thewisker.github.io/Shikai

  • The demo wallpapers do not fit on some aspect ratios, thus look out of place, but that can be fixed when the theme is installed by changing the wallpapers for ones with the correct aspect ratios.

Screenshots []

Main theme screenshot

Behaviour settings screenshot

Style settings screenshot

Themes settings screenshot

Second main screenshot

Installation []

If not installing through the AUR you need to: Once all dependencies are installed, download a release. Then, uncompress said release into a resulting folder.

Arch Linux

You can install Shikai from the AUR repository:

  • For information on how to install an AUR package read this wiki.

Then you should edit /etc/lightdm/web-greeter.yml to your liking focusing on the following lines:

  • theme: shikai
  • background_images_dir: /usr/share/web-greeter/themes/shikai/assets/media/wallpapers/
  • logo_image: /usr/share/web-greeter/themes/shikai/assets/media/logos/

Then, to set up a user profile image, copy the desired image to the user's home directory renaming it to .face.

Script

To install using the scripts just execute the following bash files under ./scripts from the release root directory.

Then, to set up a user profile image, copy the desired image to the user's home directory renaming it to .face.

Manually

First, go to the dist directory located on the release folder and open the index.html and monitor.htmlfiles. Search in both files for window.__is_debug = true; and change it to window.__is_debug = false;. Then, copy the dist folder to /usr/share/web-greeter/themes/, renaming it from dist to shikai. Then, you need to change the line starting with greeter-session= in /etc/lightdm/lightdm.conf to greeter-session=web-greeter or greeter-session=nody-greeter, depending on which you have installed. Finally, you should edit /etc/lightdm/web-greeter.yml to your liking focusing on the following lines:

  • theme: shikai
  • background_images_dir: /usr/share/web-greeter/themes/shikai/assets/media/wallpapers/
  • logo_image: /usr/share/web-greeter/themes/shikai/assets/media/logos/

Also, to set up a user profile image, copy the desired image to the user's home directory renaming it to .face.

Updating []

When updating Shikai just keep in mind that if the new version contains breaking changes you must delete localStorage with the button in the settings panel before making the update. Apart from that, just update it as if you were installing it overwriting in the case of a manual install.

Dependencies []

Buildtime

The Shikai theme has no buildtime dependencies.

Runtime

The theme depends on web-greeter or nody-greeter and their respective dependencies, plus lightdm.

Configuration []

The configuration button becomes avaiable by hovering over the top-left corner of the window. The behaviour and style settings are saved locally only when the configuration panel gets closed. The themes configuration gets saved on theme creation, deletion and activation.

Discussions []

Feel free to give any ideas for future improvements here, ask any questions you have here and post screenshots of your theme designs here.

Troubleshooting []

  • Profile image not loading:

If you have added a .face image to you home folder and it does not load on theme it is probably due to the access permisions of the .face file. To fix this issue, copy the .face image to /var/lib/AccountsService/icons/ renaming it to your user's name. Once done, change its permisions with chmod 644 /var/lib/AccountsService/icons and chmod 644 /var/lib/AccountsService/icons/username. Lastly, create/modify the following configuration file /var/lib/AccountsService/users/username including the following line: Icon=/var/lib/AccountsService/icons/username

  • Incomplete loading:

On the odd case that the demo or the theme itself only loads the backgrounds or does not load the settings, it is most probably due to a recent update that contains changes to the settings JSON structure. This can be fixed manually, looking at the errors in the developer console, and manually adding the missing keys and values, or easier by deleting the page's localStorage.

Contributions []

First and foremost, all contributions are welcome! The steps involved when making a contribution are explained in the CONTRIBUTING.md file. We look forward to your contributions!

  • The contributors list is located here.

Translations []

Secondly, all translations are also welcome! The steps involved when making a translation are explained in the CONTRIBUTING.md file. More specific steps can be found in the CONTRIBUTING.md file in the /src/lang folder. We look forward to your translations!

  • The credits of the translators are located here.

Metrics []

Notes []

  • Change wallpapers by adding or removing from /usr/share/web-greeter/themes/shikai/assets/media/wallpapers/ path!
  • Undefined behaviour for adding non-browser-compliant images and non-image files to the wallpapers directory!
  • Missing linux distro logo? Submit a pull request!
  • Missing language? Submit a pull request including it in ./src/lang! Further details here.
  • Have a really cool wallpaper to add to the live demo? Submit a pull request!

License []

Code of Conduct []

This project follows the Contributor Covenant Code of Conduct.

Author []

TheWisker