This repository is a place for third-party developers to share their plugins written for Safe Eyes. You have the full freedom to distribute and share using any mediums. However, I have created this repository as a place which is easily accessible to the developers via the link shared in the Safe Eyes official website.
I welcome Safe Eyes users to write their own custom plugins and share them here by sending a pull request. However, I do apply some restrictions to the plugins if you want them to be added to this repository:
The plugin must be shared under GPL v3 license.
WHY? I highly believe and support FOSS and among the licenses, I know so far, GPL v3 ensures that the users have full freedom on the code. Further, if anyone copies your code, they must release their entire product under GPL v3 which is good for the FOSS community.
Please add the GPL v3 license header in plugin.py
file.
The plugin must have an icon.
The plugin should be highly cohesive. If you have several ideas, develop them as individual plugins.
24x24
pixel png
images for plugin icon and tray action icon#acacac
color for tray action icon#000000
color for plugin iconI highly recommend exporting Font Awesome icons to png using this nifty tool: http://fa2png.io for all your icons.
If you are providing a tray action (a button on the top right corner of the break screen), place the tray action icon as <plugin-path>/resource/<icon-name>.png
. Please check the official Screensaver plugin for better understanding.
Clone this repository
git clone https://github.com/safeeyes/safeeyes-plugins.git
Create a new folder ~/.config/safeeyes/plugins
if it does not exist already.
mkdir ~/.config/safeeyes/plugins
Copy the desired plugin folder to the above directory.
cp -r ./safeeyes-plugins/weather ~/.config/safeeyes/plugins/weather
Restart Safe Eyes
Check the Plugins tab in Safe Eyes settings dialog for the newly installed plugin.
Notice: I try my best to manually analyze the plugins submitted by other developers to ensure that they don't misuse the plugin. I hope other users using Safe Eyes also will keep an eye on this. Anyhow as everything is under GPL v3 license, the plugins are distributed WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.