search

rpmfusion-infra / fedy

Fedy makes it easy to install third-party software in Fedora.
GNU General Public License v3.0
187 stars 20 forks source link

readme

fedy

Copr build status | License

Screen

Introduction

Fedy lets you install multimedia codecs and additional software that Fedora doesn't want to ship, like H264 support, Adobe Flash, Oracle Java etc., and much more with just a few clicks.

Installation

Installation instructions can be found on https://github.com/rpmfusion-infra/fedy.

Do not follow instructions from any other source!

# RPM Fusion
sudo dnf install https://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm https://download1.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-$(rpm -E %fedora).noarch.rpm

# Install fedy copr repository
sudo dnf copr enable kwizart/fedy

# Install fedy
sudo dnf install fedy -y

# For EL8 (RHEL, CentOS and derivates), the support is still experimental (please report issues)

Usage

After installation, search for Fedy in the menu/overview or type fedy in the terminal.

Plugin structure

Plugins can be placed under ~/.local/share/fedy/plugins/, or the system plugins directory.

Each plugin is a directory with the suffix .plugin, which consist of a JSON formatted metadata file. The metadata file contains information about the plugin and describes how Fedy should run the tasks.

The plugins can run any command or scripts (bash, python etc.). In addtion to the system commands, Fedy provides an additional command, run-as-root to allow running commands (e.g.- run-as-root touch /some/file/somewhere) or scripts (e.g.- run-as-root -s do-stuff.sh) as root.

Have a look at the existing plugins to know more about how to write plugins for Fedy.

Source code

Source code is publicly available on GitHub, and automatically cloned to GitLab:


$ git clone https://github.com/rpmfusion-infra/fedy

Bugs and feature requests

Please submit bugs and feature requests here. Pull requests are always welcome.

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but 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.

You should have received a copy of the GNU General Public License along with this program. If not, see gnu.org/licenses.