deep-tempest

Restoration for TEMPEST images using deep-learning

https://github.com/emidan19/deep-tempest

Science Score: 67.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 2 DOI reference(s) in README
  • Academic publication links
    Links to: arxiv.org
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (6.6%) to scientific vocabulary

Keywords

deep-learning gnu-radio image-restoration pytorch sdr tempest
Last synced: 6 months ago · JSON representation ·

Repository

Restoration for TEMPEST images using deep-learning

Basic Info
  • Host: GitHub
  • Owner: emidan19
  • License: other
  • Language: Python
  • Default Branch: main
  • Homepage:
  • Size: 494 MB
Statistics
  • Stars: 617
  • Watchers: 12
  • Forks: 85
  • Open Issues: 8
  • Releases: 0
Topics
deep-learning gnu-radio image-restoration pytorch sdr tempest
Created over 1 year ago · Last pushed 9 months ago
Metadata Files
Readme License Citation

README.md

Deep-tempest: Using Deep Learning to Eavesdrop on HDMI from its Unintended Electromagnetic Emanations

Summary

In this project we have extended the original gr-tempest (a.k.a. Van Eck Phreaking or simply TEMPEST; i.e. spying on a video display from its unintended electromagnetic emanations) by using deep learning to improve the quality of the spied images. See an illustrative diagram above. Some examples of the resulting inference of our system and the original unmodified version of gr-tempest below.

The following external webpages provide a nice summary of the work: * NewScientist: AI can reveal what’s on your screen via signals leaking from cables * RTL-SDR.com: DEEP-TEMPEST: EAVESDROPPING ON HDMI VIA SDR AND DEEP LEARNING * PC World: Hackers can wirelessly watch your screen via HDMI radiation * Techspot: AI can see what's on your screen by reading HDMI electromagnetic radiation * Futura: Hallucinant : ce système permet d’afficher et espionner ce qu’il y a sur l’écran d’un ordinateur déconnecté * hackster.io: Deep-TEMPEST Reveals All * Hacker News: Deep-Tempest: Using Deep Learning to Eavesdrop on HDMI * TechXplore: Security researchers reveal it is possible to eavesdrop on HDMI cables to capture computer screen data * Tom's Hardware: AI can snoop on your computer screen using signals leaking from HDMI cables — researchers develop new AI model that enables using antennas for long-range attacks * Montevideo Portal: ¿Por qué la inteligencia artificial puede ver una pantalla? Un estudio uruguayo indagó * El Observador: Uruguayos interceptan señales del cable HDMI para espiar monitores y asombran al mundo * El País: La amenaza invisible: uruguayos descubrieron cómo un hacker podría espiar tu pantalla a través del cable HDMI

Video demo

We are particularly interested in recovering the text present in the display, and we improve the Character Error Rate from 90% in the unmodified gr-tempest, to less than 30% using our module. Watch a video of the full system in operation:

How does it works? (and how to cite our work or data)

You can find a detailed technical explanation of how deep-tempest works in our article. If you found our work or data useful for your research, please consider citing it as follows:

```` @inproceedings{deep_tempest, author = {Fern\'{a}ndez, Santiago and Mart\'{\i}nez, Emilio and Varela, Jorge and Mus\'{e}, Pablo and Larroca, Federico}, title = {Deep-TEMPEST: Using Deep Learning to Eavesdrop on HDMI from its Unintended Electromagnetic Emanations}, year = {2024}, url = {https://doi.org/10.1145/3697090.3697094}, booktitle = {Proceedings of the 13th Latin-American Symposium on Dependable and Secure Computing (LADC '24)}, }

````

Data

In addition to the source code, we are also open sourcing the whole dataset we used. Follow this dropbox link to download a ZIP file (~7GB). After unzipping, you will find synthetic and real captured images used for experiments, training, and evaluation during the work. These images consists of 1600x900 resolution with the SDR's center frequency at the third pixel-rate harmonic (324 MHz).

The structure of the directories containing the data is different for synthetic data compared to captured data:

Synthetic data

  • ground-truth (directory with reference/monitor view images)

    • image1.png
    • ...
    • imageN.png
  • simulations (directory with synthetic degradation/capture images)

    • image1_synthetic.png
    • ...
    • imageN_synthetic.png

Real data

  • image1.png (image1 ground-truth)
  • ...
  • imageN.png (imageN ground-truth)

  • Image 1 (directory with captures of image1.png)

    • capture1_image1.png
    • ...
    • captureM_image1.png
  • ...

  • Image N (directory with captures of image1.png)

    • capture1_imageN.png
    • ...
    • captureM_imageN.png

Code and Requirements

Clone the repository:

shell git clone https://github.com/emidan19/deep-tempest.git

Both gr-tempest and end-to-end folders contains a guide on how to execute the corresponding files for image capturing, inference and train the deep learning architecture based on DRUNet from KAIR image restoration repository.

deep-tempest Environment Setup

This guide describes how to set up the environment for using the deep-tempest repository. You can choose between two setup options: using Conda or Pyenv + venv. The code works with both Python 3.12 and Python 3.10, and has been tested on Ubuntu 22.04.5 LTS and Ubuntu 24.04.2 LTS, so you can choose either version depending on your system and preference. The example below use Python 3.12.

The system runs with CUDA 12.4, but the environment uses the PyTorch and Torchvision build for CUDA 12.1, as it is the latest stable release officially provided by PyTorch.


Prerequisite (Required for All Options):

Before setting up the environment, you must install Tesseract OCR:

bash sudo apt update sudo apt install tesseract-ocr

Option 1: Using Conda:

Create and activate a new Conda environment:

shell conda create -n deeptempest python=3.12 conda activate deeptempest

Install dependencies from the provided YAML file:

shell conda env update --file tempest_conda.yml

Install additional required packages:

shell pip install torch==2.5.1+cu121 torchvision==0.20.1+cu121 --index-url https://download.pytorch.org/whl/cu121 pip install pybind11==2.13.6 pip install --no-build-isolation git+https://github.com/sfernandezr/fastwer.git

Option 2: Using Pyenv + venv

Create and activate a virtual environment:

shell python3.12 -m venv deeptempest cd deeptempest source bin/activate

Install dependencies from tempest_pyenv file:

shell pip install -r tempest_pyenv.txt

Install additional required packages manually:

shell pip install torch==2.5.1+cu121 torchvision==0.20.1+cu121 --index-url https://download.pytorch.org/whl/cu121 pip install pybind11==2.13.6 pip install --no-build-isolation git+https://github.com/sfernandezr/fastwer.git

Regarding installations with GNU Radio, it is necessary to use the gr-tempest version in this repository (which contains a modified version of the original gr-tempest). After this, run the following grc files flowgraphs to activate the hierblocks: - binary_serializer.grc - FFT_autocorrelate.grc - FFT_crosscorrelate.grc - Keep1inNframes.grc

Finally run the flowgraph deep-tempest_example.grc to capture the monitor images and be able to recover them with better quality using the Save Capture block.

Credits

IIE Instituto de Ingeniería Eléctrica, Facultad de Ingeniería, Universidad de la República, Montevideo, Uruguay, http://iie.fing.edu.uy/investigacion/grupos/artes/

Please refer to the LICENSE file for contact information and further credits.

Owner

  • Name: Emilio Daniel Martinez Rocca
  • Login: emidan19
  • Kind: user

Citation (CITATION.cff)

@misc{fernández2024deeptempestusingdeeplearning,
      title={Deep-TEMPEST: Using Deep Learning to Eavesdrop on HDMI from its Unintended Electromagnetic Emanations}, 
      author={Santiago Fernández and Emilio Martínez and Gabriel Varela and Pablo Musé and Federico Larroca},
      year={2024},
      eprint={2407.09717},
      archivePrefix={arXiv},
      primaryClass={cs.CR},
      url={https://arxiv.org/abs/2407.09717},
      note={Submitted}
}

GitHub Events

Total
  • Issues event: 4
  • Watch event: 107
  • Issue comment event: 23
  • Push event: 1
  • Fork event: 15
Last Year
  • Issues event: 4
  • Watch event: 107
  • Issue comment event: 23
  • Push event: 1
  • Fork event: 15

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 4
  • Total pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Total issue authors: 4
  • Total pull request authors: 0
  • Average comments per issue: 2.0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 3
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 3
  • Pull request authors: 0
  • Average comments per issue: 0.0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • Diddle1 (1)
  • shencangsheng (1)
  • Jackjiang313 (1)
  • mferris3CS1003 (1)
  • filippt1 (1)
  • bar-mm (1)
  • pierreay (1)
Pull Request Authors
  • AMAG-AB (1)
  • FlUxIuS (1)
Top Labels
Issue Labels
Pull Request Labels

Dependencies

end-to-end/requirement.txt pypi
  • einops *
  • hdf5storage *
  • lmdb *
  • ninja *
  • opencv-python *
  • pillow *
  • requests *
  • scikit-image *
  • timm *
  • torchvision *
requirements.txt pypi
  • alembic =1.8.1=pyhd8ed1ab_0
  • appdirs =1.4.4=pyhd3eb1b0_0
  • blas =1.0=mkl
  • blosc =1.21.3=h6a678d5_0
  • brotli =1.0.9=h5eee18b_7
  • brotli-bin =1.0.9=h5eee18b_7
  • brotlipy =0.7.0=py39h27cfd23_1003
  • brunsli =0.1=h2531618_0
  • bzip2 =1.0.8=h7b6447c_0
  • c-ares =1.19.0=h5eee18b_0
  • ca-certificates =2023.05.30=h06a4308_0
  • cairo =1.16.0=hf32fb01_1
  • certifi =2023.7.22=py39h06a4308_0
  • cffi =1.15.1=py39h5eee18b_3
  • cfitsio =3.470=h5893167_7
  • charls =2.2.0=h2531618_0
  • charset-normalizer =2.0.4=pyhd3eb1b0_0
  • cloudpickle =2.0.0=pyhd3eb1b0_0
  • cmaes =0.10.0=pyhd8ed1ab_0
  • colorama =0.4.6=pyhd8ed1ab_0
  • colorlog =6.7.0=py39hf3d152e_1
  • contourpy =1.0.5=py39hdb19cb5_0
  • cryptography =39.0.1=py39h9ce1e76_0
  • cuda-cudart =11.8.89=0
  • cuda-cupti =11.8.87=0
  • cuda-libraries =11.8.0=0
  • cuda-nvrtc =11.8.89=0
  • cuda-nvtx =11.8.86=0
  • cuda-runtime =11.8.0=0
  • cycler =0.11.0=pyhd3eb1b0_0
  • cytoolz =0.12.0=py39h5eee18b_0
  • dask-core =2022.7.0=py39h06a4308_0
  • dbus =1.13.18=hb2f20db_0
  • expat =2.4.9=h6a678d5_0
  • fastwer =0.1.3=pypi_0
  • ffmpeg =4.3.2=hca11adc_0
  • filelock =3.9.0=py39h06a4308_0
  • flit-core =3.8.0=py39h06a4308_0
  • fontconfig =2.13.1=h6c09931_0
  • fonttools =4.25.0=pyhd3eb1b0_0
  • freetype =2.12.1=h4a9f257_0
  • fsspec =2023.3.0=py39h06a4308_0
  • gettext =0.19.8.1=h73d1719_1008
  • giflib =5.2.1=h5eee18b_3
  • glib =2.68.4=h9c3ff4c_1
  • glib-tools =2.68.4=h9c3ff4c_1
  • gmp =6.2.1=h295c915_3
  • gmpy2 =2.1.2=py39heeb90bb_0
  • gnutls =3.6.15=he1e5248_0
  • graphite2 =1.3.13=h58526e2_1001
  • gst-plugins-base =1.14.5=h0935bb2_2
  • gstreamer =1.18.5=h76c114f_0
  • harfbuzz =2.9.1=h83ec7ef_1
  • hdf5 =1.12.1=nompi_h2750804_100
  • icu =68.2=h9c3ff4c_0
  • idna =3.4=py39h06a4308_0
  • imagecodecs =2021.8.26=py39hf0132c2_1
  • imageio =2.26.0=py39h06a4308_0
  • importlib-metadata =6.8.0=pyha770c72_0
  • importlib_resources =5.2.0=pyhd3eb1b0_1
  • intel-openmp =2021.4.0=h06a4308_3561
  • jasper =1.900.1=h07fcdf6_1006
  • jinja2 =3.1.2=py39h06a4308_0
  • joblib =1.2.0=py39h06a4308_0
  • jpeg =9e=h5eee18b_1
  • jxrlib =1.1=h7b6447c_2
  • kiwisolver =1.4.4=py39h6a678d5_0
  • krb5 =1.19.4=h568e23c_0
  • lame =3.100=h7b6447c_0
  • lcms2 =2.12=h3be6417_0
  • ld_impl_linux-64 =2.38=h1181459_1
  • leptonica =1.78.0=hb536caa_4
  • lerc =3.0=h295c915_0
  • libaec =1.0.4=he6710b0_1
  • libarchive =3.4.2=h5de8990_2
  • libblas =3.9.0=12_linux64_mkl
  • libbrotlicommon =1.0.9=h5eee18b_7
  • libbrotlidec =1.0.9=h5eee18b_7
  • libbrotlienc =1.0.9=h5eee18b_7
  • libcblas =3.9.0=12_linux64_mkl
  • libclang =11.1.0=default_ha53f305_1
  • libcublas =11.11.3.6=0
  • libcufft =10.9.0.58=0
  • libcufile =1.6.0.25=0
  • libcurand =10.3.2.56=0
  • libcurl =7.88.1=h91b91d3_0
  • libcusolver =11.4.1.48=0
  • libcusparse =11.7.5.86=0
  • libdeflate =1.8=h7f98852_0
  • libedit =3.1.20221030=h5eee18b_0
  • libev =4.33=h7f8727e_1
  • libevent =2.1.10=h9b69904_4
  • libffi =3.4.2=h6a678d5_6
  • libgcc-ng =11.2.0=h1234567_1
  • libgfortran-ng =11.2.0=h00389a5_1
  • libgfortran5 =11.2.0=h1234567_1
  • libglib =2.68.4=h174f98d_1
  • libgomp =11.2.0=h1234567_1
  • libiconv =1.16=h7f8727e_2
  • libidn2 =2.3.2=h7f8727e_0
  • liblapack =3.9.0=12_linux64_mkl
  • liblapacke =3.9.0=12_linux64_mkl
  • libllvm10 =10.0.1=hbcb73fb_5
  • libllvm11 =11.1.0=hf817b99_2
  • libnghttp2 =1.46.0=hce63b2e_0
  • libnpp =11.8.0.86=0
  • libnvjpeg =11.9.0.86=0
  • libopencv =4.5.3=py39h3eb7741_2
  • libpng =1.6.39=h5eee18b_0
  • libpq =12.9=h16c4e8d_3
  • libprotobuf =3.16.0=h780b84a_0
  • libssh2 =1.10.0=h8f2d780_0
  • libstdcxx-ng =11.2.0=h1234567_1
  • libtasn1 =4.16.0=h27cfd23_0
  • libtiff =4.4.0=hecacb30_2
  • libunistring =0.9.10=h27cfd23_0
  • libuuid =1.41.5=h5eee18b_0
  • libwebp =1.2.4=h11a3e52_1
  • libwebp-base =1.2.4=h5eee18b_1
  • libxcb =1.15=h7f8727e_0
  • libxkbcommon =1.0.3=he3ba5ed_0
  • libxml2 =2.9.12=h72842e0_0
  • libzopfli =1.0.3=he6710b0_0
  • llvmlite =0.39.1=py39he1b5a44_0
  • lmdb =0.9.29=h2531618_0
  • locket =1.0.0=py39h06a4308_0
  • lz4-c =1.9.4=h6a678d5_0
  • mako =1.2.4=pyhd8ed1ab_0
  • markupsafe =2.1.1=py39h7f8727e_0
  • matplotlib =3.7.1=py39h06a4308_1
  • matplotlib-base =3.7.1=py39h417a72b_1
  • mkl =2021.4.0=h06a4308_640
  • mkl-service =2.4.0=py39h7f8727e_0
  • mkl_fft =1.3.1=py39hd3c417c_0
  • mkl_random =1.2.2=py39h51133e4_0
  • mpc =1.1.0=h10f8cd9_1
  • mpfr =4.0.2=hb69a4c5_1
  • mpmath =1.2.1=py39h06a4308_0
  • munkres =1.1.4=py_0
  • mysql-common =8.0.25=ha770c72_2
  • mysql-libs =8.0.25=hfa10184_2
  • ncurses =6.4=h6a678d5_0
  • nettle =3.7.3=hbbd107a_1
  • networkx =2.8.4=py39h06a4308_1
  • ninja =1.10.2=h06a4308_5
  • ninja-base =1.10.2=hd09550d_5
  • nspr =4.33=h295c915_0
  • nss =3.74=h0370c37_0
  • numba =0.56.4=np1.16py3.9h59fbc97_g288a38bbd_0
  • numpy =1.23.5=py39h14f4228_0
  • numpy-base =1.23.5=py39h31eccc5_0
  • opencv =4.5.3=py39hf3d152e_2
  • openh264 =2.1.1=h4ff587b_0
  • openjpeg =2.4.0=h3ad879b_0
  • openssl =1.1.1u=h7f8727e_0
  • optuna =3.2.0=pyhd8ed1ab_0
  • packaging =23.0=py39h06a4308_0
  • partd =1.2.0=pyhd3eb1b0_1
  • pcre =8.45=h295c915_0
  • pillow =9.4.0=py39h6a678d5_0
  • pip =23.0.1=py39h06a4308_0
  • pixman =0.40.0=h36c2ea0_0
  • plotly =5.9.0=py39h06a4308_0
  • ply =3.11=py39h06a4308_0
  • pooch =1.4.0=pyhd3eb1b0_0
  • py-opencv =4.5.3=py39hef51801_2
  • pybind11 =2.11.1=pypi_0
  • pycparser =2.21=pyhd3eb1b0_0
  • pyopenssl =23.0.0=py39h06a4308_0
  • pyparsing =3.0.9=py39h06a4308_0
  • pyqt =5.12.3=py39h03dd644_4
  • pyqt5-sip =4.19.18=pypi_0
  • pyqtchart =5.12=pypi_0
  • pyqtwebengine =5.12.1=pypi_0
  • pysocks =1.7.1=py39h06a4308_0
  • pytesseract =0.3.10=pyhd8ed1ab_0
  • python =3.9.16=h7a1cb2a_2
  • python-dateutil =2.8.2=pyhd3eb1b0_0
  • python_abi =3.9=2_cp39
  • pytorch =2.0.0=py3.9_cuda11.8_cudnn8.7.0_0
  • pytorch-cuda =11.8=h7e8668a_3
  • pytorch-mutex =1.0=cuda
  • pywavelets =1.4.1=py39h5eee18b_0
  • pyyaml =6.0=py39h5eee18b_1
  • qt =5.12.9=h9d6b050_2
  • readline =8.2=h5eee18b_0
  • requests =2.28.1=py39h06a4308_1
  • scikit-image =0.19.3=py39h6a678d5_1
  • scikit-learn =1.2.2=py39h6a678d5_1
  • scipy =1.10.0=py39h14f4228_1
  • setuptools =65.6.3=py39h06a4308_0
  • sip =6.6.2=py39h6a678d5_0
  • six =1.16.0=pyhd3eb1b0_1
  • snappy =1.1.9=h295c915_0
  • sqlalchemy =1.3.24=py39hb9d737c_1
  • sqlite =3.41.1=h5eee18b_0
  • sympy =1.11.1=py39h06a4308_0
  • tenacity =8.2.2=py39h06a4308_0
  • tesseract =4.1.1=hfcf31d1_4
  • threadpoolctl =2.2.0=pyh0d69192_0
  • tifffile =2021.7.2=pyhd3eb1b0_2
  • tk =8.6.12=h1ccaba5_0
  • toml =0.10.2=pyhd3eb1b0_0
  • toolz =0.12.0=py39h06a4308_0
  • torchaudio =2.0.0=py39_cu118
  • torchtriton =2.0.0=py39
  • torchvision =0.15.0=py39_cu118
  • tornado =6.2=py39h5eee18b_0
  • tqdm =4.65.0=pyhd8ed1ab_1
  • typing_extensions =4.4.0=py39h06a4308_0
  • tzdata =2022g=h04d1e81_0
  • urllib3 =1.26.14=py39h06a4308_0
  • wheel =0.38.4=py39h06a4308_0
  • x264 =1
  • xz =5.2.10=h5eee18b_1
  • yaml =0.2.5=h7b6447c_0
  • zfp =0.5.5=h295c915_6
  • zipp =3.11.0=py39h06a4308_0
  • zlib =1.2.13=h5eee18b_0
  • zstd =1.5.2=ha4553b6_0