Skip to content

Commit 0f74345

Browse files
committed
Major Update: Add new themes, update layout and CSS, improve README, add contributing instructions.
1 parent 8c2bed7 commit 0f74345

File tree

7 files changed

+543
-228
lines changed

7 files changed

+543
-228
lines changed

CONTRIBUTING.md

Lines changed: 76 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,76 @@
1+
# Contributing to Wallpaper Theme Converter
2+
3+
Thank you for considering contributing to Wallpaper Theme Converter!
4+
5+
## How to Contribute
6+
7+
1. **Fork the repository**: Click the "Fork" button at the top right of the repository page.
8+
2. **Clone your fork**:
9+
```sh
10+
git clone https://github.com/your-username/WallpaperThemeConverter.git
11+
```
12+
3. **Create a branch**:
13+
```sh
14+
git checkout -b your-branch-name
15+
```
16+
4. **Make your changes**: Implement your feature or bug fix.
17+
5. **Commit your changes**:
18+
```sh
19+
git commit -m "Description of your changes"
20+
```
21+
6. **Push to your fork**:
22+
```sh
23+
git push origin your-branch-name
24+
```
25+
7. **Create a Pull Request**: Go to the original repository and click "New Pull Request".
26+
27+
## Reporting Issues
28+
29+
If you find a bug or have a feature request, please open an issue on GitHub. Provide as much detail as possible to help us understand and address the issue.
30+
31+
## Adding a Theme
32+
33+
To add a theme, you need to modify three files:
34+
35+
- [index.html](index.html)
36+
- [themes.json](./assets/themes.json)
37+
- [README.md](README.md)
38+
39+
### Changes in index.html
40+
41+
Follow the `<!-- For Developers:` comments.
42+
43+
### Changes in themes.json
44+
45+
[themes.json](./assets/themes.json) contains a JS object that has the following structure:
46+
47+
```js
48+
{
49+
"Theme": [
50+
r,g,b,
51+
r,g,b,
52+
r,g,b,
53+
...
54+
r,g,b
55+
],
56+
...
57+
"Theme": [
58+
r,g,b,
59+
r,g,b,
60+
...
61+
r,g,b
62+
]
63+
}
64+
```
65+
66+
Each r,g, and b value is stored one after another in an array of integers, where r,g,b represents one colour of the theme.
67+
68+
Please ensure that the order remains the same as listed in index.html. Add your palette in r,g,b values.
69+
70+
### Changes in README.md
71+
72+
Please add the theme name in the README with a link to the GitHub repository of the theme.
73+
74+
## Contributing Elsewhere
75+
76+
Feel free to modify whatever you'd like in addition to adding themes. Styling, changing the layout, optimizing JS, etc. is welcome. Please ensure that you explain these kinds of changes in detail when opening a PR.

LICENSE

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
MIT License
22

3-
Copyright (c) 2022 Neel Patel
3+
Copyright (c) 2022-2025 Neel Patel
44

55
Permission is hereby granted, free of charge, to any person obtaining a copy
66
of this software and associated documentation files (the "Software"), to deal

README.md

Lines changed: 26 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
# [Wallpaper Theme Converter](https://notneelpatel.github.io/WallpaperThemeConverter)
22

3+
[https://notneelpatel.github.io/WallpaperThemeConverter](https://notneelpatel.github.io/WallpaperThemeConverter)
4+
35
### A webpage that converts any image to any colour palette.
46

57
![example](https://user-images.githubusercontent.com/91706742/167537142-11c1f406-e614-479f-9701-92460a90fcef.png)
@@ -8,10 +10,13 @@ Adjust the colours to a wallpaper to better match your setup, terminal, and/or I
810

911
- [Gruvbox](https://github.com/morhetz/gruvbox)
1012
- [Nord](https://github.com/arcticicestudio/nord)
13+
- [Everforest](https://github.com/sainnhe/everforest)
1114
- [Solarized](https://github.com/altercation/solarized)
12-
- [Catppuccin](https://github.com/catppuccin/catppuccin) (Thanks [Marcus](https://github.com/cheezytaco101)!)
1315
- [Dracula](https://github.com/dracula/dracula-theme)
14-
- [Everforest](https://github.com/sainnhe/everforest) (Thanks [jn-sena](https://github.com/jn-sena)!)
16+
- [Tokyo Night](https://github.com/tokyo-night/tokyo-night-vscode-theme)
17+
- [Kanagawa](https://github.com/rebelot/kanagawa.nvim)
18+
- [Catppuccin](https://github.com/catppuccin/catppuccin)
19+
- [Rosé Pine](https://github.com/rose-pine/rose-pine-theme)
1520
- Custom Theme (add your own colours!)
1621

1722
Inspired by [Gruvbox Factory](https://github.com/paulopacitti/gruvbox-factory) and [ImageGoNord](https://github.com/Schrodinger-Hat/ImageGoNord)
@@ -20,15 +25,31 @@ Inspired by [Gruvbox Factory](https://github.com/paulopacitti/gruvbox-factory) a
2025

2126
![this took way too long](https://user-images.githubusercontent.com/91706742/167540042-26458707-ff23-413e-bce1-2141b562fc1e.png)
2227

28+
Note: There are more themes than just the ones listed here.
29+
2330
## Instructions
2431

2532
1. Drag/Drop an image or click on "Browse" to select your image.
2633
2. Select a theme.
27-
3. If you want to do a custom theme, select "Custom Theme" and press the + button to add colours. Click on the colour swatch (the black block with the white outline) and change the colour to whatever you'd like. Press "Done" when you are ready.
34+
3. If you want to do a custom theme, select "Custom Theme" and press the + button to add colours. Click on the colour swatch (the black block) and change the colour to whatever you'd like. Press "Done" when you are ready.
2835
4. Press "Convert"
29-
5. Wait!! It may take a few seconds, especially if you have lower-end hardware. You will know that it is done when you see the "Download" button and "Reset Image" button.
36+
5. Wait! It may take a few seconds, especially if you have lower-end hardware. You will know that it is done when you see the "Download" button and "Reset Image" button.
3037
6. Download the image if you'd like, or if you want to try another palette, press "Reset Image" and repeat steps 3-5.
3138

3239
## How it works
3340

34-
I wrote a blog post in 2022 explaining more about how it works. Check it out: https://notneelpatel.github.io/blog/2022-05-10-wallpaper-theme-converter.html
41+
I wrote a blog post in 2022 explaining more about how it works. Check it out: [https://notneelpatel.github.io/blog/2022-05-10-wallpaper-theme-converter.html](https://notneelpatel.github.io/blog/2022-05-10-wallpaper-theme-converter.html)
42+
43+
## Contributors
44+
45+
Thank you to all of the contributers! You can find the contributor list [here](https://github.com/NotNeelPatel/WallpaperThemeConverter/graphs/contributors)
46+
47+
If you would like to contribute, see [CONTRIBUTING.md](CONTRIBUTING.md)
48+
49+
## Self-Hosting/Running Locally
50+
51+
In the event that you would like to host Wallpaper Theme Converter or run locally for development purposes, you can do so very easily as there are no JS dependencies or libraries for this website. This is a pure HTML + CSS + JS implementation. Simply clone this repository and open `index.html`.
52+
53+
## License
54+
55+
This project is under an [MIT License](LICENSE). I would appreciate it if you could credit me and/or provide a link to this GitHub repository.

0 commit comments

Comments
 (0)