Gnuradio blocks and tools for receiving GSM transmissions
Clone or download
axilirator apps/grgsm_trx: (re)structurize help message
Change-Id: I612d8ae7d3ff99fee809e10d95919989bfbe0f59
Latest commit ed03e41 Sep 21, 2018
Failed to load latest commit information.
apps apps/grgsm_trx: (re)structurize help message Sep 21, 2018
cmake Simplify cmake checks related to libosmocore Jun 19, 2018
dists/debian Updated changelog for Ubuntu's PPA Sep 11, 2017
docs Changes so that rst2man presence is optional and not mandatory to com… Sep 23, 2017
examples @ 32727fc Updated examples pointer Dec 1, 2017
grc gsm_trx_burst_if: allow to customize the bind address Aug 10, 2018
hier_blocks GRC file for gsm gmsk mod Sep 27, 2017
include/grgsm gsm_trx_burst_if: allow to customize the bind address Aug 10, 2018
lib burst_file_source: Fix reading longer bursts Sep 13, 2018
python apps/grgsm_trx: remove redundant unit from freq_offset variable name Sep 13, 2018
swig Fix includes after moving trx_burst_if May 6, 2018
test_data @ e2e5b44 Add tch_f_decoder tests Apr 6, 2018
tests tests: Fix Debian and Kali dockerfiles Jul 28, 2018
.gitignore Updates .gitignore and examples pointer Nov 11, 2017
.gitmodules Changed submodule URLs to point to osmocom servers Aug 31, 2018
.gitreview Add .gitreview similar to the other osmocom's projects Sep 13, 2018
.travis.yml Do not test with debtest-grgsm-package container Mar 30, 2018
CMakeLists.txt Increasing version number Aug 12, 2018
COPYING Big update of copyright statements so they can be automatically proce… Aug 23, 2017
LICENSE Added separate file for short license notice (that is used for exampl… Dec 15, 2014 Added more copyright holders Mar 22, 2018 Keep the old mailing list for now Jul 12, 2018 Changed arrangment of directories and names of files for testing Apr 11, 2016

The gr-gsm project

The gr-gsm project is based on the gsm-receiver written by Piotr Krysik (also the main author of gr-gsm) for the Airprobe project.

The aim is to provide set of tools for receiving information transmitted by GSM equipment/devices.

Installation and usage

Please see project's wiki for information on installation and usage of gr-gsm.

Mailing list

Current gr-gsm project's mailing list address is following:

Mailing list is a place for general discussions, questions about the usage and installation. In case of problem with installation please try to provide full information that will help reproducing it. Minimum information should contain:

  • operating system with version,
  • kind of installation (how gr-gsm and its dependencies were installed: with pybombs, from distibution's repository, compiled manually)
  • version of gnuradio (it can be obtained with: gnuradio-companion --version)
  • error messages (in case of pybombs installation they can be obtained after switching it to verbous mode with -v option).

To join the group with any e-mail address, use this link:!forum/gr-gsm/join


New features are accepted through github's pull requests. When creating pull request try to make it adress one topic (addition of a feature x, correction of bug y).

If you wish to develop something for gr-gsm but don't know exactly what, then look for issues with label "Enhancement". Select one that you feel you are able to complete. After that claim it by commenting in the comment section of the issue. If there is any additional information about gr-gsm needed by you to make completing the task easier - just ask.


Short presentation of Airprobe'like application of gr-gsm:


Piotr Krysik <ptrkrysik (at)> - main author and project maintainer

Roman Khassraf <rkhassraf (at)> - blocks for demultiplexing and decoding of voice channels, decryption block supporting all ciphers used in GSM, blocks for storing and reading GSM bursts, project planning and user support

Vadim Yanitskiy <axilirator (at)> - control and data interface for the transceiver, grgsm_trx application

Vasil Velichkov <vvvelichkov (at)> - automatic compilation of grc applications, fixes and user support

Pieter Robyns <pieter.robyns (at)> - block reversing channel hopping


This work is built upon the efforts made by many people to gather knowledge of GSM.

First very significant effort of public research into GSM and its security vulnerabilities was The Hacker's Choice GSM SCANNER PROJECT. One of the results of this project was creation of a software GSM receiver by Tvoid - gsm-tvoid - which was was the most important predecessor of gr-gsm and of gsm-receiver from the Airprobe project.

Gr-gsm wouldn't be also possible without help and inspiration by Harald Welte, Dieter Spaar and Sylvain Munaut.

Special thanks to Pawel Koszut who generously lent his USRP1 to the author of gr-gsm (Piotr Krysik) in 2007-2010.