Car Logos Dataset 🚗

A comprehensive collection of 383 car manufacturer logos with multiple size variations and metadata. This dataset provides high-quality logos in different formats, making it perfect for automotive-related applications, research, or design projects.

📦 Features

383 unique car manufacturer logos
Three size variations for each logo:
- Original high-resolution images
- Optimized versions (smaller file size, maintained quality)
- Thumbnails (256px height)
Detailed JSON metadata for each logo
MIT licensed (logos remain property of respective owners)
Regular updates (Last crawled: November 28, 2024)

📂 Repository Structure

/logos
  /optimized/   # Optimized logos with reduced file size
  /thumb/       # 256px height thumbnails
  /original/    # Original crawled images
  data.json     # Metadata for all logos
/src            # Source code for crawler and processing

🛠 Installation & Usage

# Clone the repository
git clone https://github.com/filippofilip95/car-logos-dataset.git

# Install dependencies
npm install

# Run the crawler and processor
npm start

📝 Usage Examples

1. Local Usage

Download the repository and use images with their relative paths:

{
  "name": "Volkswagen",
  "slug": "volkswagen",
  "image": {
    "localThumb": "./thumb/volkswagen.png",
    "localOptimized": "./optimized/volkswagen.png",
    "localOriginal": "./original/volkswagen.jpg",
    "source": "https://www.carlogos.org/logo/Volkswagen-logo-2019-640x500.jpg"
  }
}

2. Remote Usage

Embed logos directly using GitHub raw URLs:

{
  "name": "Volkswagen",
  "slug": "volkswagen",
  "image": {
    "thumb": "https://raw.githubusercontent.com/filippofilip95/car-logos-dataset/master/logos/thumb/volkswagen.png",
    "optimized": "https://raw.githubusercontent.com/filippofilip95/car-logos-dataset/master/logos/optimized/volkswagen.png",
    "original": "https://raw.githubusercontent.com/filippofilip95/car-logos-dataset/master/logos/original/volkswagen.jpg"
  }
}

🤝 Contributing

We welcome contributions! The crawler and optimization scripts are written in TypeScript and located in the /src/ directory.

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

For major changes, please open an issue first to discuss what you would like to change.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Note: All logo images are the property of their respective owners and are subject to their own licensing terms.

🔍 Data Source

Logo images are crawled from Carlogos.org and processed for optimal usage.

📫 Support

Create an Issue for bug reports or feature requests
Star the repository if you find it useful!