@@ -7,11 +7,21 @@ Inspired by [Raycast](https://github.com/raycast) and [Wofi](https://github.com/
77Built with performance and simplicity in mind, Peppy offers a fast way to open ** GUI application** from a beautiful and minimal interface.
88Peppy supports Wayland as well as X11 windowing protocols
99
10- ## Demo
10+ # Demo
1111
1212https://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
4151curl -sSL https://raw.githubusercontent.com/Deepanshusharwan/peppy/main/build.sh | bash
4252```
4353
44- ### Manual Install:
54+ ## Manual Install:
4555
46561 . ** Clone the repo and cd into it**
4757
@@ -65,7 +75,7 @@ uv pip install .
6575pip 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
70804 . ** 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```
119129peppy
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```
131141python 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