You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Hosted Weblate 748fd2d3c5 Update translation files 6 months ago
.idea Organize Python imports 2 years ago
debian Appdata: Newer releases must be at the top 7 months ago
doc Point to GitHub's deploy keys docs and add info on server SSH keys 2 years ago
docker Add alls commands and .env var in readme for installation 1 year ago
repomaker Update translation files 6 months ago
tests Make tests work in virtual environment 10 months ago
.dockerignore Add README for Docker deployment 1 year ago
.gitignore Add prototype docker container 1 year ago
.gitlab-ci.yml gitlab-ci: use more secure token passing 8 months ago
.pylintrc Fix issue with background_task migration 2 years ago
.travis.yml Reinstall Java on OS X CI to get latest version 2 years ago
CHANGELOG.md Bump version to 1.0.0b1 7 months ago
Dockerfile Actually install a SSH client in the docker image 1 year ago
LICENSE First working prototype 2 years ago
MANIFEST.in Include tests in source distribution and use new website 1 year ago
README.md Bump Django to latest LTS release 1.11.20 6 months ago
manage.py Make repomaker installable 2 years ago
package.json Use pinned version for material-design-icons-iconfont 10 months ago
pre-release.sh Don't delete fonts on release 9 months ago
purge.sh Add pre-release script and move stuff to data directory 2 years ago
requirements-dev.txt [#142] Gallery screen: add clear filter button 1 year ago
requirements-gui.txt Add a window with pywebview and an application shortcut 2 years ago
requirements.txt Bump Django to latest LTS release 1.11.20 6 months ago
run-tests.sh Parallelize tests 2 years ago
run.sh Download remote app icons in dedicated tasks 2 years ago
setup.cfg Improve installation instructions 1 year ago
setup.py Bump Django to latest LTS release 1.11.20 6 months ago
setup.sh Provide more information in readme 10 months ago
update-translations.sh Updated translations from Weblate 1 year ago

README.md

build status coverage report translation status

Installation

There are several different ways to install Repomaker.

Ubuntu/Debian

In F-Droid’s Ubuntu ppa exists a package of Repomaker which might also work on Debian and other Debian based systems. You can install it like this:

sudo add-apt-repository ppa:fdroid/repomaker
sudo apt update
sudo apt install repomaker

Flatpak

Repomaker is available as Flatpak and distributed on Flathub. Once you got Flatpak installed on your system, either go to your system’s app store or execute the following commands:

flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak install flathub org.fdroid.Repomaker

PyPi

If you don’t want or can’t install Repomaker with one of the mentioned methods, you can install it with pip from PyPi.

Requirements

Please make sure you have the following requirements installed before proceeding with the installation.

Install

  • pip for installation of Python 3 dependencies
  • virtualenv to create an isolated Python environment
  • Python development and build files for installing/building some dependencies

On Debian, you can simply run this:

apt install python3-pip python3-wheel python3-dev virtualenv build-essential

Runtime

  • keytool from Java Runtime Environment (JRE)
  • apksigner or alternatively jarsigner from Java Development Kit (JDK)
  • Android Asset Packaging Tool (aapt)
  • libmagic for mime-type detection
  • rsync to publish repositories
  • git to publish repositories to git mirrors

On Debian, you can simply run this:

sudo apt install openjdk-8-jre-headless apksigner aapt libmagic1 rsync git

Install into virtual environment

To not mess with other Python libraries you have installed, we will install repomaker into its own isolated Python environment.

virtualenv -p /usr/bin/python3 repomaker
source repomaker/bin/activate
pip install repomaker[gui]

You should now be able to start by typing:

repomaker

If you want to work on repomaker, please see the development section below.

Troubleshooting

First check that you really have all dependencies from above installed.

If the installation fails with something about openssl, try to install libssl-dev with apt install libssl-dev.

If starting repomaker fail with the error Could not find `keytool` program., you might run into this known issue. Try if apt install openjdk-8-jdk-headless fixes it for you.

If the graphical user interface fails to start, you can try running repomaker-server and repomaker-tasks. If that works, you should be able to open 127.0.0.1:8000 in your browser.

On a server / Docker

Note that you can run Repomaker on a server and make use of its multi user functionality. See Docker docs and the general docs for more information on that topic.

Development

To work on repomaker, you need npm to fetch CSS and JavaScript dependencies: apt install npm.

Then run npm install to install these dependencies.

If you want to run repomaker in your browser rather then using the GUI, you can start it like this:

virtualenv -p /usr/bin/python3 repomaker
source repomaker/bin/activate
./setup.sh
./run.sh

Translation

  • GNU gettext apt install gettext

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero 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 Affero General Public License for more details.

Translating

Everything can be translated. See Translation and Localization for more info.

  • To update translations, run ./update-translations.sh.
  • To add a new translation, run python3 manage.py makemessages -l <lg> where <lg> is the language code, e.g. de.

translation status