Giter VIP home page Giter VIP logo

shikai's Introduction

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

shikai's People

Contributors

faisal-beep22 avatar teschnei avatar thewisker 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.