{"id":50938175,"url":"https://github.com/simula/pysim","last_synced_at":"2026-06-17T11:04:09.129Z","repository":{"id":95089933,"uuid":"539912655","full_name":"simula/pysim","owner":"simula","description":"pySim SIM/USIM card reader/writer software","archived":false,"fork":false,"pushed_at":"2023-12-14T11:48:37.000Z","size":1195,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-04-17T21:17:51.271Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/simula.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2022-09-22T09:57:13.000Z","updated_at":"2024-04-11T06:15:57.000Z","dependencies_parsed_at":"2023-03-05T07:00:24.638Z","dependency_job_id":null,"html_url":"https://github.com/simula/pysim","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/simula/pysim","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simula%2Fpysim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simula%2Fpysim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simula%2Fpysim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simula%2Fpysim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/simula","download_url":"https://codeload.github.com/simula/pysim/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simula%2Fpysim/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34445186,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-17T02:00:05.408Z","response_time":127,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-17T11:04:08.215Z","updated_at":"2026-06-17T11:04:09.123Z","avatar_url":"https://github.com/simula.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"pySim - Read, Write and Browse Programmable SIM/USIM/ISIM/HPSIM Cards\n=====================================================================\n\nThis repository contains a number of Python programs that can be used\nto read, program (write) and browse all fields/parameters/files on\nSIM/USIM/ISIM/HPSIM cards used in 3GPP cellular networks from 2G to 5G.\n\nNote that the access control configuration of normal production cards\nissue by operators will restrict significantly which files a normal\nuser can read, and particularly write to.\n\nThe full functionality of pySim hence can only be used with on so-called\nprogrammable SIM/USIM/ISIM/HPSIM cards.\n\nSuch SIM/USIM/ISIM/HPSIM cards are special cards, which - unlike those\nissued by regular commercial operators - come with the kind of keys that\nallow you to write the files/fields that normally only an operator can\nprogram.\n\nThis is useful particularly if you are running your own cellular\nnetwork, and want to configure your own SIM/USIM/ISIM/HPSIM cards for\nthat network.\n\n\nHomepage\n--------\n\nPlease visit the [official homepage](https://osmocom.org/projects/pysim/wiki)\nfor usage instructions, manual and examples.\n\n\nDocumentation\n-------------\n\nThe pySim user manual can be built from this very source code by means\nof sphinx (with sphinxcontrib-napoleon and sphinx-argparse).  See the\nMakefile in the 'docs' directory.\n\nA pre-rendered HTML user manual of the current pySim 'git master' is\navailable from \u003chttps://downloads.osmocom.org/docs/latest/pysim/\u003e and\na downloadable PDF version is published at\n\u003chttps://downloads.osmocom.org/docs/latest/osmopysim-usermanual.pdf\u003e.\n\nA slightly dated video presentation about pySim-shell can be found at\n\u003chttps://media.ccc.de/v/osmodevcall-20210409-laforge-pysim-shell\u003e.\n\n\npySim-shell vs. legacy tools\n----------------------------\n\nWhile you will find a lot of online resources still describing the use of\npySim-prog.py and pySim-read.py, those tools are considered legacy by\nnow and have by far been superseded by the much more capable\npySim-shell.  We strongly encourage users to adopt pySim-shell, unless\nthey have very specific requirements like batch programming of large\nquantities of cards, which is about the only remaining use case for the\nlegacy tools.\n\n\nGit Repository\n--------------\n\nYou can clone from the official Osmocom  git repository using\n```\ngit clone https://gitea.osmocom.org/sim-card/pysim.git\n```\n\nThere is a web interface at \u003chttps://gitea.osmocom.org/sim-card/pysim\u003e.\n\n\nInstallation\n------------\n\nPlease install the following dependencies:\n\n - bidict\n - cmd2 \u003e= 1.5.0\n - colorlog\n - construct \u003e= 2.9.51\n - gsm0338\n - jsonpath-ng\n - packaging\n - pycryptodomex\n - pyscard\n - pyserial\n - pytlv\n - pyyaml \u003e= 5.1\n - smpp.pdu (from `github.com/hologram-io/smpp.pdu`)\n - termcolor\n\nExample for Debian:\n```sh\nsudo apt-get install --no-install-recommends \\\n\tpcscd libpcsclite-dev \\\n\tpython3 \\\n\tpython3-setuptools \\\n\tpython3-pycryptodome \\\n\tpython3-pyscard \\\n\tpython3-pip\npip3 install --user -r requirements.txt\n```\n\nAfter installing all dependencies, the pySim applications ``pySim-read.py``, ``pySim-prog.py`` and ``pySim-shell.py`` may be started directly from the cloned repository.\n\nIn addition to the dependencies above ``pySim-trace.py`` requires ``tshark`` and the python package ``pyshark`` to be installed. It is known that the ``tshark`` package\nin Debian versions before 11 may not work with pyshark.\n\n### Archlinux Package\n\nArchlinux users may install the package ``python-pysim-git``\n[![](https://img.shields.io/aur/version/python-pysim-git)](https://aur.archlinux.org/packages/python-pysim-git)\nfrom the [Arch User Repository (AUR)](https://aur.archlinux.org).\nThe most convenient way is the use of an [AUR Helper](https://wiki.archlinux.org/index.php/AUR_helpers),\ne.g. [yay](https://aur.archlinux.org/packages/yay) or [pacaur](https://aur.archlinux.org/packages/pacaur).\nThe following example shows the installation with ``yay``.\n\n```sh\n# Install\nyay -Sy python-pysim-git\n\n# Uninstall\nsudo pacman -Rs python-pysim-git\n```\n\n\nMailing List\n------------\n\nThere is no separate mailing list for this project. However,\ndiscussions related to pysim-prog are happening on the\n\u003copenbsc@lists.osmocom.org\u003e mailing list, please see\n\u003chttps://lists.osmocom.org/mailman/listinfo/openbsc\u003e for subscription\noptions and the list archive.\n\nPlease observe the [Osmocom Mailing List\nRules](https://osmocom.org/projects/cellular-infrastructure/wiki/Mailing_List_Rules)\nwhen posting.\n\n\nContributing\n------------\n\nOur coding standards are described at\n\u003chttps://osmocom.org/projects/cellular-infrastructure/wiki/Coding_standards\u003e\n\nWe are using a gerrit-based patch review process explained at\n\u003chttps://osmocom.org/projects/cellular-infrastructure/wiki/Gerrit\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimula%2Fpysim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimula%2Fpysim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimula%2Fpysim/lists"}