Skip to content

Commit ceeba97

Browse files
Update docs for v3.1.0
1 parent 3ba8105 commit ceeba97

1 file changed

Lines changed: 46 additions & 16 deletions

File tree

‎Readme.md‎

Lines changed: 46 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -7,11 +7,21 @@ Inspired by [Raycast](https://github.com/raycast) and [Wofi](https://github.com/
77
Built with performance and simplicity in mind, Peppy offers a fast way to open **GUI application** from a beautiful and minimal interface.
88
Peppy supports Wayland as well as X11 windowing protocols
99

10-
## Demo
10+
# Demo
1111

1212
https://github.com/user-attachments/assets/588bcf6a-d648-4b8e-a3cc-66e80afe3256
1313

14-
## Features
14+
# Content list:
15+
* [Features](#features)
16+
* [Installation](#installation--)
17+
* [Usage](#usage--)
18+
* [Customization](#customization)
19+
* [File Tree Structure](#file-tree-structure)
20+
* [Planned Feature](#planned-features)
21+
* [Thanks](#thanks-to)
22+
* [Contributors](#-contributors)
23+
24+
# Features
1525

1626
- ⚡ **Lightning-fast fuzzy search** for installed apps
1727
- ⌨️ **Full keyboard navigation** – `Enter`, `Esc`, `↑ ↓`, `Ctrl+C`, etc.
@@ -27,21 +37,21 @@ https://github.com/user-attachments/assets/588bcf6a-d648-4b8e-a3cc-66e80afe3256
2737
- 🐧 Linux and macOS support
2838
- 🛠️ **Modular and extensible** codebase
2939

30-
## Installation ->
40+
# Installation ->
3141

32-
### Prerequisites:
42+
## Prerequisites:
3343

3444
- Python 3.10 or later installed on your system
3545
- Git installed for cloning the repository
3646
- Pip
3747

38-
### Install with a Single command:
48+
## Install with a Single command:
3949

4050
```bash
4151
curl -sSL https://raw.githubusercontent.com/Deepanshusharwan/peppy/main/build.sh | bash
4252
```
4353

44-
### Manual Install:
54+
## Manual Install:
4555

4656
1. **Clone the repo and cd into it**
4757

@@ -65,7 +75,7 @@ uv pip install .
6575
pip install pyinstaller
6676
```
6777

68-
#### Note: Stop here and move to the Usage instructions if you simply want to run it as a script and not a binary
78+
### Note: Stop here and move to the Usage instructions if you simply want to run it as a script and not a binary
6979

7080
4. **For Linux**
7181

@@ -107,31 +117,31 @@ pyinstaller --onedir --clean --strip \
107117
src/main.py
108118
```
109119

110-
## Usage ->
120+
# Usage ->
111121

112-
### Launching the program:
122+
## Launching the program:
113123

114-
#### Case 1: systemwide install
124+
### Case 1: systemwide install
115125

116126
- simply launch it from the terminal
117127

118128
```
119129
peppy
120130
```
121131

122-
#### Case 2: Only built the exec file and not installed.
132+
### Case 2: Only built the exec file and not installed.
123133

124134
```
125135
./dist/peppy/peppy
126136
```
127137

128-
#### Case 3: Run without building the app
138+
### Case 3: Run without building the app
129139

130140
```
131141
python src/main.py
132142
```
133143

134-
### Using Peppy:
144+
## Using Peppy:
135145

136146
- Launch the application
137147
![](./assets/screenshot1.png)
@@ -143,7 +153,7 @@ python src/main.py
143153

144154
- typing anywhere will directly put the text in the searchbar
145155

146-
#### Use External scripts and commands:
156+
### Use External scripts and commands:
147157

148158
- Put a '/' before running a command and press enter to run it.
149159
![](./assets/screenshot3.png)
@@ -153,7 +163,16 @@ python src/main.py
153163
- Every command you type will be stored in the textbox
154164
![](./assets/screenshot5.png)
155165

156-
#### Use the colour converter:
166+
### Use the dictionary:
167+
168+
FORMAT: \
169+
```meaning <word>```
170+
171+
- Type the word you want the meaning for in the above format
172+
![](./assets/screenshot10.png)
173+
174+
175+
### Use the colour converter:
157176

158177
- Put a '#' before entering the hex or the rgb value and press enter to check it out
159178
![](./assets/screenshot6.png)
@@ -164,7 +183,8 @@ python src/main.py
164183
- If an invalid value is entered then the dialogue box will show the colour of the background
165184
![](./assets/screenshot9.png)
166185

167-
## Customization
186+
187+
# Customization
168188

169189
- You can customize peppy by putting css inside the peppy.conf to customize it to your needs.
170190
- if you accidentally delete it don't worry just run peppy and it will automatically recreate the configuration file.
@@ -251,6 +271,10 @@ Total files: 58
251271
- Plugin/extension system
252272
- Integration with clipboard, browser bookmarks, system settings
253273

274+
## Thanks to
275+
- [meetDeveloper](https://github.com/meetDeveloper/freeDictionaryAPI) (For the dictionary api)
276+
- [Contributors](#-contributors)
277+
254278
## Listing bugs
255279

256280
💡 Found a bug or want to suggest a feature? [Open an Issue](https://github.com/Deepanshusharwan/peppy/issues)
@@ -268,3 +292,9 @@ Pull requests are welcome! Feel free to fork this repo, open issues, and suggest
268292

269293
[Gaurav Vashisht](https://github.com/r2adio) \
270294
[ClanEver](https://github.com/ClanEver)
295+
296+
<a href="https://github.com/deepanshusharwan/peppy/graphs/contributors">
297+
<img src="https://contrib.rocks/image?repo=deepanshusharwan/peppy" />
298+
</a>
299+
300+
Made with [contrib.rocks](https://contrib.rocks).

0 commit comments

Comments
 (0)