ShadowFox/README.md

41 lines
2.6 KiB
Markdown

![header](.github/Screenshots/header.png)
ShadowFox was inspired by changes made in Firefox 57, which limited the amount addons could customize both the user interface and "protected" web pages.
This project aims at creating a universal dark theme for Firefox while adhering to the modern design principles set by Mozilla.
You can visit the ShadowFox website at [overdodactyl.github.io/ShadowFox/](https://overdodactyl.github.io/ShadowFox/).
## Preview
![preferences](.github/Screenshots/preview.png)
ShadowFox styles the entire user interface, protected webpages (such as `about:` pages and addons.mozilla.org), and over 40 popular addons.
## Installation and Updating
A cross-platform installer/uninstaller/updater is maintained in the [shadowfox-updater](https://github.com/SrKomodo/shadowfox-updater) repository. Latest versions can be found in the [releases](https://github.com/SrKomodo/shadowfox-updater/releases) section, or via `Homebrew` and `AUR`. Please see the [README](https://github.com/SrKomodo/shadowfox-updater/blob/master/README.md) file for details on how to use the updater (GUI and CLI options available) and solutions to common problems.
## Customization
It's easy to customize ShadowFox, everything from the colors used to what elements and webpages are styled. For more information, see [here](https://github.com/overdodactyl/ShadowFox/wiki/Customization).
Depending on how much you want to customize ShadowFox, you may be better suited using a different installation process. To learn more, see [here](https://github.com/overdodactyl/ShadowFox/wiki/Development).
## Discussion
* Chat about ShadowFox on Slack - [invitation link](https://join.slack.com/t/shadowfox-workspace/shared_invite/enQtMzU3NTU2NTQ0NDA1LTcwN2I1M2I4MzlkMWFlMWEzODc2MTY1NzU2NjhlYTgzOGY5ZTQzM2UxZTFiZDMxNDM1NDMyNjlhOWQ4MWQ3ZDc)
## Find a bug? Have a feature request? Have any questions?
Please first read through the [wiki](https://github.com/overdodactyl/ShadowFox/wiki/) (including the getting started information, troubleshooting, and known problems) and take a look at any open [issues](https://github.com/overdodactyl/ShadowFox/issues). If you can't find a duplicate request, bug, or an answer to your question, please feel free to either:
* Open a [new issue](https://github.com/overdodactyl/ShadowFox/issues/new)
* Make a post on the ShadowFox [Reddit page](https://www.reddit.com/r/ShadowFoxCSS/).
## Contributing
I welcome any contributions and would be excited to have a team of people helping with this project. If you are uncomfortable making pull requests, you can simply open up an issue and attach any code you would like included.