Git Product home page Git Product logo

apps's Introduction

YunoHost apps directory

![roundcube](https://yunohost.org/images/roundcube.png) ![ttrss](https://yunohost.org/images/ttrss.png) ![wordpress](https://yunohost.org/images/wordpress.png) ![transmission](https://yunohost.org/images/transmission.png) ![jappix](https://yunohost.org/images/jappix.png)

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

https://yunohost.org/apps

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

screenshot

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.git",
        "state": "working"
    }

How to propose your app to be integrated in the official applications list

Here is the procedure to request that your app will be part of the list of official applications of YunoHost:

  • before everything, having you application joining the list of official applications will make you a maintainer of it and will requires you to ensure this position or to find someone else to do it in the future
  • your app must be tested on several architectures (32/64 bits, ARM) or depends on cross-platform systems
  • you must be subscribed to the apps official mailing list since this is the way that we communicate to apps maintainers
  • your application package must have the following scripts:
  • a install script, obviously
  • a remove script
  • an upgrade script if needed
  • a backup/restore script if your application stores data
  • your application must be installable on a custom path (domain.tld/custom_path/) in addition to the root path (some.domain.tld/)
  • if relevant, your application must be integrated with YunoHost SSO
  • the application you have packaged must be free software, as in free speech
  • once all those requirements are fulfilled, fork this repository, add your application to the official.json list with the status "validated" following the documentation above, then open a pull request
  • we will then start a reviewing process and we will work together to bring your application to a state where we can hopefully include it to the official applications list :)

Since our documentation regarding all those part is not as complete as it should be, don't hesitate to ask questions on the apps mailing list regarding those points.

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

More information on yunohost.org/packaging_apps

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.