apps's Introduction

YunoHost apps directory

Here you will find the repositories and versions of every apps integrated in YunoHost.

Lists

official.json contains the repository information of validated apps.
community.json contains all references to known YunoHost packages. If you want to add your app to the list, please send a Pull Request

Usage

The official package list is automatically fetched. If you want to enable the community package list on your YunoHost instance:

sudo yunohost app fetchlist -n community -u https://yunohost.org/community.json

Contributing

How to add your app to the community list

Fork and edit the community list
Add your app's ID and git information at the right alphabetical place
Indicate the app's functioning state: notworking, inprogress, or working
Send a Pull Request

App example addition:

    "wallabag": {
        "branch": "master",
        "revision": "c2fc62438ac5c9503e3f4ebfdc425ec03a0ec0c0",
        "url": "https://github.com/abeudin/wallabag_ynh",
        "state": "working"
    }

N.B. : You can now put HEAD as revision. This way, you won't have to come and update this file each time you change things in your app. But this also means that any change to your master branch will be made available to everybody. Hence, when developing things which are not production-ready, if you use HEAD we strongly recommend that you develop in a testing branch (for instance) until you consider things stable enough to be merged in master.

How to help translating

We invite you to use translate.yunohost.org instead of doing Pull Request for files in locales folder.

Helper script

You can use the add_or_update.py python script to add or update your app from one of the 2 json files.

Usage:

./add_or_update.py [community.json OR official.json] [github/gitlab url OR app name [github/gitlab url OR app name [github/gitlab url OR app name ...]]]