Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/nitanmarcel/oem-gsi-builder

Port OEM ROMs to project treble using github actions and ErfanGSIs then upload to sourceforge.
https://github.com/nitanmarcel/oem-gsi-builder

erfan-tool erfangsis gsi gsis treble treble-experience

Last synced: 8 days ago
JSON representation

Port OEM ROMs to project treble using github actions and ErfanGSIs then upload to sourceforge.

Host: GitHub
URL: https://github.com/nitanmarcel/oem-gsi-builder
Owner: nitanmarcel
License: mit
Created: 2021-05-18T10:19:15.000Z (over 3 years ago)
Default Branch: master
Last Pushed: 2022-08-31T15:50:49.000Z (over 2 years ago)
Last Synced: 2024-05-02T02:36:19.720Z (8 months ago)
Topics: erfan-tool, erfangsis, gsi, gsis, treble, treble-experience
Language: Shell
Homepage:
Size: 9.77 KB
Stars: 23
Watchers: 3
Forks: 97
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

Port OEM ROMs to project treble using github actions and [ErfanGSIs](https://github.com/erfanoabdi/ErfanGSIs) then upload to sourceforge.

# Features
- Easy to use.
- Customizable. Chose your own custom ErfanGSIs tool, chose build type (A only or AB or both), and many more.
- Deploy ported GSI to sourceforge.
- Send notifications on telegram with informations about the latest build.

# Requirements
- A little understanding on how to use ErfanGSIs tool.
- A SourceForge account and project.
- A little understanding on how SourceForge works and how to use it with sftp.

# How To Use
- Fork the repo.
- Setup ErfanGSIs configuration in config.env. See [ErfanGSIs Configuration](#ErfanGSIs-Configuration).
- Setup SourceForge credentials in github secrets. See [SourceForge Configuration](#SourceForge-Configuration).
- Go to actions tab, enable workflows.
- Go to Actions tab again, click and run workflow manually.
- It should take around 10 to succesfully build and upload your builds to sourceforge.com.

# How to update
- Change ErfanGSIs configuration in config.env. [ErfanGSIs Configuration](#ErfanGSIs-Configuration).
- Go to actions tab, click and run workflow manually.
- It should take around 10 to succesfully build and upload your builds to sourceforge.com.

# ErfanGSIs Configuration
> All the settings for Erfan's tool is available by editing the config.env file.

**Name**|**Description**|**Required**
:-----:|:-----:|:-----:
TOOL\_REPO| Repository from where to clone ErfanGSIs tool. Only change this if you are using a custom one.
URL| Firmware download link or path on the repo.
FIRMWARE\_TYPE| Firmware type (eg: Pixel).
OUTPUT\_TYPE| Build type. Can be: "all" to build AB and AOnly; "ab" to build just AB; "a" to build just AOnly.
SOURCEFORGE\_DIR| The directory on sourceforge. See: https://sourceforge.net/p/forge/documentation/SFTP/#for-managing-file-releases
TG\_CHAT\_IDS| List of telegram chat id separated by space where to send info about the latest builds. Set to 0 to disable telegram notifications.
SOURCEFORGE\_URL| Url to the sourceforge directory where the builds are uploaded. Used if telegram notifications are enabled.
EXTRA\_ARGS| Extra arguments to pass to url2GSI.sh script.

# SourceForge Configuration

> In order to connect to source forge you need some extra configuration variables in your repo secrets. See [here](https://docs.github.com/en/actions/reference/encrypted-secrets).

# Donate

> Remember that all the credits for the gsi porting tool belong to Erfan so if your GSI booted succesfully all of this is because of him. But if you wish to thank me for creating this github workflow and you find it helpfull you can also help me with a donation.

- Paypal: https://paypal.me/marcelalexandrunitan?locale.x=en_US
- Revolut: https://revolut.me/nitanmarcel
- BTC: 3HYhqCW95UcK5eyPQVkgYBVdjKF8HXoQ1z