SIMrw

Little tool for reading or writing GSM phonebooks as CSV to/from a USIM card with an PC/SC compatible reader.

Command line only. More to come. Perhaps. :)

Usage (more description to come):

      ____ ___ __  __               
     / ___|_ _|  \/  |_ ____      __
     \___ \| || |\/| | '__\ \ /\ / /
      ___) | || |  | | |   \ V  V / 
     |____/___|_|  |_|_|    \_/\_/  
                                
***** SIMrw vX.X.X by Micha Salopek *****
see: https://github.com/salopeknet/SIMrw

usage: SIMrw.py [-h] (-r | -w | -rd | -wd) [-v] [-p PIN] csv_file [reader_nb]

Read or write GSM phonebooks as CSV to/from a USIM card with an PC/SC compatible reader.

positional arguments:
  csv_file           CSV file name for reading or writing
  reader_nb          Reader number (default: 0 if omitted)

options:
  -h, --help         show this help message and exit
  -r, --read         Read phonebook from the USIM card and save as CSV
  -w, --write        Write CSV phonebook to the USIM card
  -rd, --readdump    Write direct APDU responses (dump) as HEX-Bytes to CSV (bytewise backup)
  -wd, --writedump   Write Dump: Write HEX-Bytes from (dumped) CSV to USIM card
  -v, --verbose      Show names & numbers during reading/writing
  -p PIN, --pin PIN  PIN for the USIM card (default: None if omitted)

Download & first run:

Download latest release here

For each Platform there are two versions to download. Just download and unpack (if it doesn't happen automatically on your system):

*-ONEFILE: This is one single executable file, which gets self-extracted at each program start to some temp-directory.
This is the first choice and should work for most of you guys!

*-ONEDIR: This is a single directory distribution with all needed files/libraries which you unpack manually. Then you can start SIMrw directly from there.
This version could be slightly quicker, as it doesn't self-extract every time at startup like ONEFILE-version.

Note

On macOS you'll have run it with [option]+[Right Click] -> Open the first time to confirm the security warning.
If you prefer Terminal, type in the folder where you have downloaded SIMrw to:
xattr -r -d com.apple.quarantine ./SIMrw
If you get some weird error message from macOS-security complaining about 'Python', try xattr -r -d com.apple.quarantine ./Python in program folder.

Note

Some (Windows-) antivirus could really freak out but this is false positive! If you do not trust you can still use the Python script.

Note

The downloadable executables are tested on Windows 10 and macOS Sonoma. If you know how, better use the Python script natively.

Format of CSV-file:

Either read out a SIM phonebook first and then edit the created CSV-file. Please avoid using Excel for CSV-editing, because it does funny things with CSV-data...

Or start a new one like in this example:

1;Name1;+491711234567
2;Name2;01727890123
3;Name3;123456789
4;;
5;Name5;987654321
...

First field/column is the 'index number', second the 'name', third the 'phone number'. Max. chars in name is 18 (I think). No header line. Delimiter is ';'. If you have empty records/lines in your CSV, always keep at least the 'index number' (followed by ';;') as a placeholder.

Thanks go out to:

Ludovic Rousseau for his project pyscard, on which this tool is based at. Merci beaucoup!