🚗 Car Catalog - Your Personal Vehicle Management App

A feature-rich desktop application to organize, manage, and track your car collection with an intuitive interface and powerful tools.

✨ Features

📋 Core Management

• Add/Edit/Delete Cars - Easily manage your car inventory
• Search & Filter - Find cars by Make, Model, Year, or Color
• Sort by Columns - Click column headers to sort by any field
• Favorites System - Mark and filter your favorite vehicles
• Car Ratings - Rate cars with 1-5 star system

📊 Data & Analytics

• Statistics Dashboard - View total value, average prices, breakdowns by status/year
• CSV Import/Export - Bulk import cars or export your catalog
• PDF Export - Generate professional PDF reports of your collection
• Depreciation Calculator - Calculate car value over time with multiple models
• Print Preview - Preview and export detailed car information

🖼️ Media Management

• Image Gallery - Browse multiple photos per car with thumbnail strip
• Video Support - Store and play car videos
• Photo Navigation - Easy navigation between car photos

🎨 User Experience

• Dark Mode - Easy on the eyes for extended use
• Multi-Currency Support - Display prices in USD ($), EUR (€), GBP (£), JPY (¥), CHF, CAD (C$), AUD (A$), or INR (₹)
• Keyboard Shortcuts - Quick access to common functions:
  • Ctrl+Z - Undo last action
  • Ctrl+Y - Redo action
  • Ctrl+N - Add new car
  • Ctrl+E - Edit selected car
  • Delete - Delete selected car
• Tooltips - Hover over buttons for helpful descriptions
• Search History - Quick access to previous searches

🛠️ Advanced Features

• Undo/Redo System - Revert or restore changes (up to 20 actions)
• Context Menu - Right-click on cars for quick actions
• Pagination - Efficiently handles 1000+ cars without lag
• Validation - Built-in validation for years, prices, and mileage
• Car Details Panel - Comprehensive view of all car information

🚀 Getting Started

Requirements

• Python 3.7+
• Required packages:

  pip install pillow cryptography reportlab

Installation

1. Clone or download this repository
2. Install dependencies:

   pip install pillow cryptography reportlab

3. Run the application:

   python maingg.py

📖 User Guide

Adding a Car

1. Click ➕ Add Car button
2. Fill in required fields (Make, Model, Year, Color)
3. Add optional details (price, mileage, fuel type, etc.)
4. Upload photos and videos
5. Click Save Car

Importing Cars from CSV

1. Click 📥 Import button
2. Follow the CSV format guide that appears
3. Select your CSV file
4. Review the preview
5. Click Import to add all cars

CSV Format Required:

Make,Model,Year,Color,Price,Mileage (km),Fuel Type,Transmission,Notes,Photos,Video
Toyota,Corolla,2020,Blue,$18500,45000,Petrol,Auto,Good condition,photo1.jpg,
Honda,Civic,2019,Silver,$16800,52000,Petrol,Manual,New tires,photo2.jpg,

Searching Cars

1. Select search category from dropdown (All, Make, Model, Year, Color)
2. Enter your search query
3. Results update in real-time
4. Click Clear to reset

Viewing Car Details

• Double-click any car in the list to open detailed view
• Or right-click and select View Details
• Navigate between photos with Previous/Next buttons
• Edit, rate, or manage favorites from detail view

Exporting Data

• CSV Export: Click 📊 CSV to export all cars
• PDF Export: Click 📄 PDF to create a printable catalog
• Statistics: Click 📈 Stats for comprehensive analytics

Managing Photos

1. Click 🖼️ Gallery to view car photos
2. Use thumbnail strip at bottom to navigate
3. Click Previous/Next to browse images
4. Double-click thumbnail to jump to that photo

Calculating Depreciation

1. Select a car
2. Click 📉 Depreciation
3. View projected values using linear (10%/year) or exponential (15%/year) models
4. See 1, 3, 5, 7, and 10-year projections

🎯 Tips & Tricks

• Bulk Operations: Import multiple cars at once using CSV
• Dark Mode: Toggle with 🌙 button for comfortable late-night browsing
• Currency Switching: Change display currency anytime with 💱 button
• Multiple Photos: Add several photos per car for better documentation
• Quick Edit: Double-click car → click Edit to modify details
• Backup: Your data is stored in cars.json - backup regularly!
• Large Catalogs: App efficiently handles 1000+ cars with pagination

📂 File Structure

car/
├── maingg.py              # Main application
├── cars.json              # Your car database
├── search_history.json    # Search history
└── [car photos & videos]  # Your media files

💾 Data Storage

• Cars Database: Stored in cars.json (plain text JSON format)
• Search History: Last 20 searches saved in search_history.json
• Photos/Videos: Store with your app or reference external paths

⌨️ Keyboard Shortcuts

Shortcut	Action
Ctrl+Z	Undo
Ctrl+Y	Redo
Ctrl+N	Add New Car
Ctrl+E	Edit Selected Car
Delete	Delete Selected Car

🎨 Customization

Themes

• Light Mode (Default): Clean, professional appearance
• Dark Mode: Reduced eye strain, modern look

Currencies Supported

• 🇺🇸 USD ($)
• 🇪🇺 EUR (€)
• 🇬🇧 GBP (£)
• 🇯🇵 JPY (¥)
• 🇨🇭 CHF
• 🇨🇦 CAD (C$)
• 🇦🇺 AUD (A$)
• 🇮🇳 INR (₹)

🐛 Troubleshooting

App won't start

• Ensure Python 3.7+ is installed
• Install required packages: pip install pillow cryptography reportlab

Images not showing

• Ensure image file paths are correct
• Supported formats: JPEG, PNG, WebP, GIF, AVIF
• Check file permissions

CSV import errors

• Verify header row matches exactly: Make,Model,Year,Color,Price,Mileage (km),Fuel Type,Transmission,Notes,Photos,Video
• All required fields must be filled: Make, Model, Year, Color
• No commas in field values (or wrap in quotes)

Performance issues

• App automatically paginates at 100 cars per view
• For 1000+ cars, use search to narrow results
• Clear search history if it grows too large

📝 Notes

• Data is stored locally in JSON format - no internet connection required
• Always backup your cars.json file regularly
• Maximum 20 undo/redo states are kept
• Search history keeps last 20 queries

🎓 Example Workflow

1. Setup: Add your current cars manually or import from CSV
2. Organize: Set status (Owned, Want to Buy, Sold, Interested)
3. Document: Add photos, videos, and notes
4. Analyze: View statistics and depreciation values
5. Export: Share your catalog as PDF or CSV
6. Maintain: Edit details, add ratings, update favorites

Windows SmartScreen Warning

If you see "Windows protected your PC" warning:

1. Click "More info"
2. Click "Run anyway"
3. The app will launch normally

This happens because the app isn't code-signed yet. It's completely safe- all source code is on GitHub!

📄 License

Free to use and modify for personal use.

🤝 Support

For issues or feature requests, please report them clearly with:

• What you were trying to do
• What went wrong
• Your app version (if available)

---

Made With Ai

Important Notice This project is currently not actively maintained. Any bugs or issues reported will not be fixed, as I am focusing on other projects at the moment. Please use this project at your own risk and be aware that there is no guarantee of support or bug fixes.

Happy car cataloging! 🏁