https://github.com/notsopreety/lockscreen
A simple and minimal lockscreen using quickshell for my hyprland system
https://github.com/notsopreety/lockscreen
hyprland lockscreen quickshell
Last synced: about 1 month ago
JSON representation
A simple and minimal lockscreen using quickshell for my hyprland system
- Host: GitHub
- URL: https://github.com/notsopreety/lockscreen
- Owner: notsopreety
- Created: 2026-04-28T06:19:56.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-28T06:25:14.000Z (3 months ago)
- Last Synced: 2026-04-28T08:24:27.568Z (3 months ago)
- Topics: hyprland, lockscreen, quickshell
- Language: QML
- Homepage:
- Size: 1.32 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Lockscreen
A minimalist, lockscreen written in [Quickshell](https://quickshell.org/) for my Hyprland workspace.
## Preview
## Installation
### 1. Clone the Repository
Clone this repository into your Quickshell configuration directory:
```bash
mkdir -p ~/.config/quickshell
git clone https://github.com/notsopreety/lockscreen ~/.config/quickshell/lockscreen
```
### 2. Install the Font
This lockscreen uses the **Anurati** font.
1. Download the font: [Anurati Font](https://font.download/dl/font/anurati.zip)
2. Extract and install:
```bash
unzip ~/Downloads/anurati.zip
mkdir -p ~/.local/share/fonts
mv ~/Downloads/Anurati-Regular.otf ~/.local/share/fonts/
fc-cache -fv
```
> **Note:** Make sure replace the wallpaper path in `LockSurface.qml`.
## Usage
Run the lockscreen with the following command:
```bash
QML2_IMPORT_PATH=~/.config/quickshell/lockscreen quickshell -p ~/.config/quickshell/lockscreen/shell.qml
```
## Features
- Media player integration (MPRIS)
- Status indicators (Battery, Wi-Fi, Bluetooth)
- Logout management
- Smooth transitions and animations
> **TIP**: Set keybindings of lockscreen in yourhyprland config for easy access.
> `bind = SUPER SHIFT, L, exec, QML2_IMPORT_PATH=~/.config/quickshell/lockscreen quickshell -p ~/.config/quickshell/lockscreen/shell.qml`