JunyiChen-ai/TrueLens

6

stars

0

commits

Python

primary language

May 13, 2026

updated

README

TrueLens: Video Fake News Detection with Dual Level Evidence Gathering and Consolidation

This repository contains the source code for the paper “TrueLens: Video Fake News Detection with Dual Level Evidence Gathering and Consolidation”.

Project Structure

  • data/ — dataset root
  • log/ — logs
  • preprocess/ — preprocessing scripts
  • src/ — training and model code

Note: we do not redistribute datasets. Please obtain videos from the original sources:

Environment

Install dependencies:

pip install -r requirements.txt

Run (from repo root)

1) Preprocess each dataset

# Extract frames (with timestamps)
python preprocess/extract_frame.py --datasets FakeSV FakeTT FVC --num_frames 16

# Build 2x2 quad mosaics
python preprocess/frames_to_quad_4.py --datasets FakeSV FakeTT FVC

# Visual features (CLIP/Chinese-CLIP)
python preprocess/make_video_feature.py --datasets FakeSV FakeTT FVC

# Convert videos to audio (WAV) and generate global transcripts (Whisper)
python preprocess/video_to_wav.py --datasets FakeSV FakeTT FVC
python preprocess/wav_to_transcript.py --datasets FakeSV FakeTT FVC

# Frame-aligned audio features (skip transcripts in this step)
python preprocess/audio_frame_processing.py --dataset FakeSV --skip_transcripts

#LLM-based descriptions (requires OPENAI_API_KEY in env; you can safely skip this step if you download our google drive data above)
python preprocess/LLM_extract.py --dataset FakeTT

# Build full-dataset retrieval artifacts
python preprocess/generate_full_retrieval.py --dataset FakeSV --use-pool --5-fold

2) Train

python src/main.py --config-name TrueLens_FakeSV
python src/main.py --config-name TrueLens_FakeTT
python src/main.py --config-name TrueLens_FVC

Citation

If you find our research useful, please kindly consider citing the following work:

@inproceedings{chen2026truelens,
  author    = {Junyi Chen and Qian Liu and Jing Sun and Yi Zhang},
  title     = {TrueLens: Video Fake News Detection with Dual Level Evidence Gathering and Consolidation},
  booktitle = {Proceedings of the ACM Web Conference 2026 (WWW '26)},
  year      = {2026},
  address   = {Dubai, United Arab Emirates},
  month     = {April 13--17},
  publisher = {ACM},
  location  = {New York, NY, USA},
  pages     = {7178--7188},
  doi       = {10.1145/3774904.3792362},
  url       = {https://doi.org/10.1145/3774904.3792362}
}

Acknowledgement

When developing this project, we referred to the following repository:

ExMRD

Thanks for their contribution.

JunyiChen-ai/TrueLens

6

stars

0

commits

Python

primary language

May 13, 2026

updated

README

TrueLens: Video Fake News Detection with Dual Level Evidence Gathering and Consolidation

This repository contains the source code for the paper “TrueLens: Video Fake News Detection with Dual Level Evidence Gathering and Consolidation”.

Project Structure

  • data/ — dataset root
  • log/ — logs
  • preprocess/ — preprocessing scripts
  • src/ — training and model code

Note: we do not redistribute datasets. Please obtain videos from the original sources:

Environment

Install dependencies:

pip install -r requirements.txt

Run (from repo root)

1) Preprocess each dataset

# Extract frames (with timestamps)
python preprocess/extract_frame.py --datasets FakeSV FakeTT FVC --num_frames 16

# Build 2x2 quad mosaics
python preprocess/frames_to_quad_4.py --datasets FakeSV FakeTT FVC

# Visual features (CLIP/Chinese-CLIP)
python preprocess/make_video_feature.py --datasets FakeSV FakeTT FVC

# Convert videos to audio (WAV) and generate global transcripts (Whisper)
python preprocess/video_to_wav.py --datasets FakeSV FakeTT FVC
python preprocess/wav_to_transcript.py --datasets FakeSV FakeTT FVC

# Frame-aligned audio features (skip transcripts in this step)
python preprocess/audio_frame_processing.py --dataset FakeSV --skip_transcripts

#LLM-based descriptions (requires OPENAI_API_KEY in env; you can safely skip this step if you download our google drive data above)
python preprocess/LLM_extract.py --dataset FakeTT

# Build full-dataset retrieval artifacts
python preprocess/generate_full_retrieval.py --dataset FakeSV --use-pool --5-fold

2) Train

python src/main.py --config-name TrueLens_FakeSV
python src/main.py --config-name TrueLens_FakeTT
python src/main.py --config-name TrueLens_FVC

Citation

If you find our research useful, please kindly consider citing the following work:

@inproceedings{chen2026truelens,
  author    = {Junyi Chen and Qian Liu and Jing Sun and Yi Zhang},
  title     = {TrueLens: Video Fake News Detection with Dual Level Evidence Gathering and Consolidation},
  booktitle = {Proceedings of the ACM Web Conference 2026 (WWW '26)},
  year      = {2026},
  address   = {Dubai, United Arab Emirates},
  month     = {April 13--17},
  publisher = {ACM},
  location  = {New York, NY, USA},
  pages     = {7178--7188},
  doi       = {10.1145/3774904.3792362},
  url       = {https://doi.org/10.1145/3774904.3792362}
}

Acknowledgement

When developing this project, we referred to the following repository:

ExMRD

Thanks for their contribution.

Languages

Python

99.4%