Skip to content
YunoHost apps directory
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
app_levels Update app_levels/en.json Mar 9, 2019
locales-community [mod] update locales-community/en.json with new translations Dec 10, 2018
locales-dev [mod] update locales-dev/en.json with new translations Jun 28, 2018
locales-official [mod] update locales-official/en.json with new translations Nov 3, 2018
locales [mod] update en.json with new translations Jun 23, 2018
.gitignore Update .gitignore Oct 25, 2015
.travis.yml
LICENSE Add license file. Mar 8, 2016
README.md Quotes around "HEAD" to be valid json Apr 9, 2019
add_or_update.py [mod] pep8 May 27, 2018
apps.json Update state for Armadietto (#773) May 22, 2019
change_level.py [enh] change_level.py uses int not and have sanity checks for that Jan 30, 2017
check_id_unicity.py [enh] add a script to check that id between app/manifest/github url i… Dec 21, 2018
community.json Added snipeit (#766) May 11, 2019
dev.json I'm done playing with this list ;) Jan 28, 2019
generate_translation_file.py [enh] add strings from community.json Mar 7, 2017
get_packager_email_addresses.sh [fix] remove file names before sorting and removing duplicate. Mar 9, 2016
hq_validation_template.md Update hq_validation_template.md Mar 9, 2019
list_builder.py
merge_official_and_community.py Uuuh re-add high-quality + working state, c.f. commit from Maniack Apr 2, 2019
official.json Merge branch 'master' into request_adoption Apr 2, 2019
pull_request_template-HQ-apps.md Update pull_request_template-HQ-apps.md Mar 24, 2019
separate_locales_between_lists.py [enh] add a script to separate translation between lists Jun 25, 2018
should_i_rebuild.sh Small hotfix to fix issues related to the new apps list Apr 25, 2019
update_translations.py [enh] modify update_translations to handle translation separation Jun 25, 2018

README.md

YunoHost apps directory

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

https://yunohost.org/apps

Lists

Situation will change soon regarding lists. Consider this info as obsolete

  • official.json contains the repository information of validated apps.
  • community.json contains all references to known "free-software" YunoHost packages. If you want to add your app to the list, please send a Pull Request
  • apps.json contains all references to known YunoHost packages. If you want to add your app to the list, please send a Pull Request. This list replace both community.json and official.json.

Usage

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

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

Contributing

How to add your app to the apps list

If your app is under a free-software licence :

  • Fork and edit the apps list
  • Add your app's ID and git information at the right alphabetical place
  • Indicate the app's functioning state: notworking, inprogress, or working
  • Do not add the level yourself. The CI will do it.
  • 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.

N.B. 2 : Organization is still debating about what to do with non-free apps listing (cf. this thread. Such a list is unlikely to be maintained by the YunoHost project officially. However, it could be created and maintained by member of the community. Check out the forum about this.

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 apps.json [github/gitlab url OR app name [github/gitlab url OR app name [github/gitlab url OR app name ...]]]

How to make my app a High Quality app ?

A High Quality app will be highlighted in the app list and marked as a level 8 app.
To become a High Quality app, a package has to follow the following rules:

  • The app should already have been in the community list for 2 months.
  • The app should be kept up to date, regarding the upstream source (if it’s possible with our current YunoHost version).
  • The package itself should be up to date regarding the packaging recommendations and helpers.
  • The package should be level 7 for at least 1 month.
  • The repository should have testing and master branches, at least. The list should point to HEAD, so the list stays up to date.
  • Any modification should be done to the testing branch, and wait at least for one approval of one member of the Apps group so that we can ensure that there’s nothing in opposition to those criteria, nor any changes that would harm servers.
  • The package should comply with the requirements of the level 8.

You can find the validation form used by Apps group here.

If the app is already tagged as High Quality and one of those criteria isn't respected anymore: after a warning, the tag will be removed until the criterion is again validated.

To make an app a High Quality app, technically, you have to add the tag "high_quality": true.

    "wallabag": {
        "branch": "master",
        "high_quality": true,
        "revision": "HEAD",
        "url": "https://github.com/abeudin/wallabag_ynh.git",
        "state": "working"
    }

How to make my app a Featured app ?

A Featured app is highlighted in the app list and shown before any others.
To become a Featured app, a package has to follow the following rules:

  • The app should already be a High Quality app.
  • The upstream app should be accessible and well made.
  • The app should be interesting and demanded by the community.
  • The app should fit the spirit of YunoHost.

Please note that the exact process to decide which apps are going to be Featured, and for how many time, isn't yet defined...

To make an app a Featured app, technically, you have to add the tag "featured": true.

    "wallabag": {
        "branch": "master",
        "high_quality": true,
        "featured": true,
        "revision": "HEAD",
        "url": "https://github.com/abeudin/wallabag_ynh.git",
        "state": "working"
    }

What to do if I can't maintain my app anymore ?

If you don't have time anymore to maintain an app, you can update its status to inform users and packagers that you will not maintain it anymore.
In order to do so, use the tag "maintained":.
This tag can have 5 different values:

  • "maintained": true That's the default value if the tag isn't present for your app. That simply means that this app is maintained.
  • "maintained": "request_help" Use that value to inform other packagers that you need help to maintain this app. You'll then be more than one maintainer for this apps.
  • "maintained": "request_adoption" Use that value to inform other packagers, as well as users, that you're going to give up that app. So that you would like another maintainer to take care of it.
  • "maintained": false or "maintained": "orphaned" This value means that this app is no longer maintained... That means also that a packager can declare himself/herself as its new maintainer.
    Please contact the Apps group if you want to take care of an unmaintained app.

If you want to modify the status of one of your apps, for any reason, please consider informing the community via the forum. Users would probably be glad to be informed that an app they use will become unmaintained.

More information

See yunohost.org/packaging_apps

You can’t perform that action at this time.