Skip to main content

Script renames all eml files in a directory using mail metadata

Project description

eml_rename project

Script renames all eml files in a directory using mail metadata


I needed this tool to classify and order my mail files at work.

I took this idea from an article of Armand Niculescu (August 20, 2014) at , so thanks an I hope you like this code.


  • Automatically renames all *.eml files in a directory, using email metadata.
  • Renamed files will have this format is 'YYYYMMDD HHMM [From] Subject'
  • If 'YYYYMMDD HHMM [From]' format is detected the script won't rename the file. With this feature user can change subject manually and the script won't overwrite it.
  • If you use --force parameter the script will overwrite all files even they have the 'YYYYMMDD HHMM [From]' format.
  • Length of the new name will have 140 character as maximum, although you can change it with the --length parameter
  • --save parameter renames files. If you don't use this parameter it will only pretend the result
  • It uses concurrency to make process faster


0.3.0 (2023-04-17)

  • migrated to poetry
  • Fix bug with CEST time zones

0.2.0 (2022-11-12)

  • Now mail datetime uses local system time zone

0.1.0 (2022-11-06)

  • First version
  • Added main features

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

eml_rename-0.3.0.tar.gz (19.2 kB view hashes)

Uploaded Source

Built Distribution

eml_rename-0.3.0-py3-none-any.whl (22.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page