Skip to content

sam-siavoshian/flag-requester

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

# Flag Collector πŸš€

A small script to help you politely request tiny flags from embassies around the world.

---

## Features

- πŸ“‘ Reads a CSV of countries and embassy emails  
- βœ‰οΈ Sends a polite, customizable request for a small flag  
- πŸ€Ήβ€β™‚οΈ Supports multiple addresses per country  
- ⏱️ Saves you from copy-pasting the same message repeatedly  

---

## Prerequisites

- Python 3.7 or newer  
- Access to an SMTP server (e.g. Gmail, Outlook)  

---

## Usage

```bash
python flag_collector.py
```

You’ll see each email that has been sent in your console.

---

## embassies.csv Format

No header rowβ€”just:

```csv
Country Name,email1@example.com,email2@example.com
Another Country,contact@embassy.org
```

---


## Troubleshooting

- βœ… Verify your SMTP credentials and server settings  
- πŸ”’ If using Gmail, enable β€œLess secure app access” or create an App Password  
- πŸ“„ Ensure `embassies.csv` is UTF-8 encoded  

---

## Contributing

Feel free to open issues or submit pull requests. All improvements welcome! πŸŽ‰

---

## License

Distributed under the **MIT License**. See `LICENSE` for details.

---

Happy flag hunting! πŸ‡ΊπŸ‡ΈπŸ‡―πŸ‡΅πŸ‡«πŸ‡·πŸ‡ΏπŸ‡¦  
β€” Saam  

*P.S. First to 50 flags earns ultimate bragging rights!*

About

Automate polite emails to embassies requesting small flags for your world collection 🌍🚩

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages