3f99397053 | ||
---|---|---|
.idea | ||
debian | ||
doc | ||
docker | ||
repomaker | ||
tests | ||
.dockerignore | ||
.gitignore | ||
.gitlab-ci.yml | ||
.pylintrc | ||
.travis.yml | ||
.weblate | ||
CHANGELOG.md | ||
Dockerfile | ||
LICENSE | ||
MANIFEST.in | ||
README.md | ||
manage.py | ||
package.json | ||
pre-release.sh | ||
purge.sh | ||
requirements-dev.txt | ||
requirements-gui.txt | ||
requirements.txt | ||
run-tests.sh | ||
run.sh | ||
setup.cfg | ||
setup.py | ||
setup.sh | ||
update-translations.sh |
README.md
Repomaker needs a maintainer, please adopt me! Repomaker currently runs on Django 1.11, which went out of security support in July 2020. Please see #234 for more information.
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 dependenciesvirtualenv
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)libmagic
for mime-type detectionrsync
to publish repositoriesgit
to publish repositories to git mirrors
On Debian, you can simply run this:
sudo apt install default-jre-headless apksigner 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 default-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
.