deep-tempest
Restoration for TEMPEST images using deep-learning
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
Repository
Restoration for TEMPEST images using deep-learning
Basic Info
Statistics
- Stars: 617
- Watchers: 12
- Forks: 85
- Open Issues: 8
- Releases: 0
Topics
Metadata Files
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
- Repositories: 1
- Profile: https://github.com/emidan19
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
- einops *
- hdf5storage *
- lmdb *
- ninja *
- opencv-python *
- pillow *
- requests *
- scikit-image *
- timm *
- torchvision *
- 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