A graphical user interface for the Osmocom project.
Go to file
Ahnaf Tahmid Chowdhury c48a6a8636 config app added 2023-09-04 23:36:02 +06:00
.github/images [ImgBot] Optimize images 2022-08-19 08:50:06 +00:00
app TLS/SSL support not available 2022-08-31 01:09:33 +06:00
config config app added 2023-09-04 23:36:02 +06:00
core TLS/SSL support not available 2022-08-31 01:09:33 +06:00
hlr TLS/SSL support not available 2022-08-31 01:09:33 +06:00
snap TLS/SSL support not available 2022-08-31 01:09:33 +06:00
static [ImgBot] Optimize images 2022-08-19 08:50:06 +00:00
templates osmo-gui v 1.0 2022-08-18 16:20:24 +06:00
.gitignore installer added 2022-08-19 00:56:49 +06:00
LICENSE.md Create LICENSE.md 2022-08-19 12:02:25 +06:00
README.md qt removed 2022-08-29 17:47:59 +06:00
db.sqlite3 osmo-gui v 1.0 2022-08-18 16:20:24 +06:00
install.sh dependencies update 2023-09-04 23:33:07 +06:00
manage.py osmo-gui v 1.0 2022-08-18 16:20:24 +06:00
requirements.txt qt removed 2022-08-29 17:47:59 +06:00
snapcraft.yaml TLS/SSL support not available 2022-08-31 01:09:33 +06:00

README.md

osmo-gui - Osmocom GUI

Osmocom

This is the graphical user interface for the Osmocom project. This program is developed with Django framework. It is a web application that allows to manage the Osmocom network. However, it is not a complete web application.

Installation

It is recommended to install the latest osmo-hlr 1.5.0 as the django app is developed for this version.

Run the following command to install the app:

$ git clone https://github.com/ahnaf-tahmid-chowdhury/osmo-gui.git
$ cd osmo-gui
$ bash install.sh

Usage

For now, only Osmocom HLR is supported. That means the app fetch the data from the Osmocom HLR vty and display it in a web page. Again one can able to add/delete/update the subscribers data through the application. However, the 'install.sh' script will install a GUI application using pywebview module thus there is no need to run the server. It will do it by own and launch the GUI program automatically. If you are interested in web application only, you can ignore the GUI installation by running the following command:

$ bash install.sh --no-gui

The server can be started by running the following command:

$ source [your-path]/osmo-gui/.env/bin/activate
$ python3 [your-path]/osmo-gui/manage.py runserver

However, osmo-hlr should be running in the background. Else the app will not be able to fetch the data.

Contributing

Contributions are welcome.

License

This project is licensed under the MIT License.