Skip to content

mar-mus/vcf_viewer

Repository files navigation

VCF Viewer

A modern, web-based VCF (vCard) file viewer built with Python and Streamlit. vibe coded for quick check.

Features

  • Multi-file Upload: Load multiple .vcf files at once.
  • Search & Filter: Quickly find contacts by name, email, or phone.
  • Interactive Table: View all contacts in a clean, sortable table.
  • Detailed View: See all fields for a selected contact.
  • Map Integration: Automatically shows the contact's location on a map if an address is provided.
  • Export: Download your filtered contact list as a CSV file.

How to Run

  1. Install Dependencies: Make sure you have Python installed, then run:

    pip install -r requirements.txt
  2. Launch the App:

    streamlit run app.py
  3. Usage:

    • Open the URL provided by Streamlit (usually http://localhost:8501).
    • Drag and drop your .vcf files into the uploader.
    • Use the sidebar to search.
    • Select a contact from the dropdown to see their details and location.

Project Structure

  • app.py: Main Streamlit application.
  • parser.py: Logic for parsing VCF files using vobject.
  • requirements.txt: List of required Python packages.
  • samples/: Contains a sample VCF file for testing.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published