Simple utility for converting a Microsoft Word Document '.doc' and Microsoft Excel '.xls' files to any other supported format such as .txt .csv .rtf .pdf.
Can also be used to convert .txt, .rtf, .csv to .doc, .xls or .pdf format.
Can be used to convert older word documents to latest format.
Must have Microsoft Word or Excel installed on host machine.
Download Release From Github Releases - https://github.com/tobya/DocTo/releases/ Further Information available at https://tobya.github.io/DocTo/ Further Examples available at https://docto.toflidium.com
More Examples available at
Download .exe from Release https://github.com/tobya/docTo/releases
Also Available for installation via Chocolatey
choco install docto
to upgrade to latest version before generally available (replace with current version)
choco upgrade docto --version=1.5
Node Wrappers has been created by @KerimG & @brrd
Please log an issue for any bugs, features or suggestions.
Convert Microsoft Word Document to text
docto -f C:\Directory\MyFile.doc -O "C:\Output Directory\MyTextFile.txt" -T wdFormatText
Convert Microsoft Excel Document to csv text
docto -XL -f C:\Directory\MyFile.xls -O "C:\Output Directory\MyTextFile.csv" -T xlCSV
Convert Microsoft Word Document to PDF (requires version of Microsoft Word that supports this).
docto -f C:\Directory\MyFile.doc -O "C:\Output Directory\MyTextFile.pdf" -T wdFormatPDF
Convert All Microsoft Word Documents in Directory and its Sub Directories to PDF
docto -f "C:\Dir with Spaces\FilesToConvert\" -O "C:\DirToOutput" -T wdFormatPDF -OX .pdf
Delete Original Files after conversion (-R) .
docto -f "C:\Dir with Spaces\FilesToConvert\" -O "C:\DirToOutput" -T wdFormatPDF -OX .pdf -R true
Add a Webhook to fire on each conversion (-W)
docto -f "C:\Dir with Spaces\FilesToConvert\" -O "C:\DirToOutput" -T wdFormatPDF -OX .pdf -W https://toflidium.com/webhooks/docto/webhook_test.php
A Webhook is a url that can be called on each converstion to give you the ability to repond externally whenever a file is converted. Currently
https address is experimental so log an issue if you have any issues.
If you are using DocTo in the wild somewhere, please add details to this wiki page
If you need to upgrade a bunch of files to work without conversion on OneDrive /Office365 / Word 20XX then you can use DocTo. See this StackExchange question
Help Version: Source: https://github.com/tobya/DocTo/ Description: DocTo converts Word Documents and Excel Spreadsheets to other formats. Command Line Parameters: Each Parameter should be followed by its value eg -f "c:\Docs\MyDoc.doc" -O "C:\MyDir\MyFile" Parameters markers are case insensitive. Short and Long can be used mixed. All parameters and values need to be seperated by a ' ' space. -H This message --HELP -? -WD Use Word for Conversion (Default) --word -XL Use Excel for Conversion --excel -PP Use Powerpoint for Conversion --powerpoint -F Input File or Directory --inputfile -FX Input Extension to search for if directory. Default "*.doc*" (will find ".docx" also) --inputextension -O Output File or Directory to place converted Docs --outputfile -OX Output Extension if -F is Directory. Please include '.' eg. '.pdf' . If not provided, pulled from standard list. --outputextension -T Format(Type) to convert file to, either integer or wdSaveFormat constant. Available from https://docs.microsoft.com/en-us/dotnet/api/microsoft.office.interop.word.wdsaveformat or https://docs.microsoft.com/en-us/dotnet/api/microsoft.office.interop.excel.xlfileformat See current List Below. --format -TF Force Format. -T value if an integer, is checked against current list compiled in. It is not passed if unavailable. -TF will pass through value without checking. Word will return an "EOleException Value out of range" error if invalid. Use instead of -T. --forceformat -L Log Level Integer: 1 ERRORS Only, 2 STANDARD, 5 CHATTY, 9 DEBUG, 10 VERBOSE. Default: 2=STANDARD --loglevel -C Compatibility Mode Integer. Set to an INTEGER value from https://msdn.microsoft.com/en-us/library/office/ff192388.aspx. Set the compatibility mode when you want to convert documents to a later version of word. See help for further info. --compatibility -E Encoding Integer: Sets codepage Encoding. See https://msdn.microsoft.com/en-us/library/office/ff860880.aspx for more details and values. --encoding -M Ignore all files in __MACOSX\ subdirectory if it exists. Default True. --ignoremacos -N Make list of files that take over n seconds to complete. Use number of seconds over that conversion takes and add to list. Outputs to filename 'docto.ignore.txt' --listlongrunning -NX Ignore any file listed in docto.ignore.txt, created by -N --ignorelongrunninglist -G Write Log to file in directory --writelogfile -GL Log File Name to Use. Default 'DocTo.Log'; --logfilename -Q Quiet Mode: Nothing will be output to console. To see any errors you must set -G or -GL. Equivalent to setting -L 0 --quiet -R Remove Files after successful conversion: Default false; To use specify value eg -R true --deletefiles -W Webhook: Url to call on events. See -HW for more details. --webhook -HW Webhook Help. -X Halt on COM Error: Default True; If you have trouble with some files not converting, set this to false to ignore errors and continue with batch job. --halterror -V Show Versions. DocTo and Word/Excel Long Parameters: --BookmarkSource PDF conversions can take their bookmarks from WordBookmarks, WordHeadings (default) or None --PDF-OpenAfterExport If you wish for a converted PDF to be opened after creation. No value req. --PDF-FromPage Save a range of pages to pdf. Integer/String. If integer --PDF-ToPage must also be set. Other values wdExportCurrentPage, wdExportSelection --PDF-ToPage Save a range of pages to pdf. Integer. --PDF-FromPage must also be set. --DoNotOverwrite Existing files are overridden by default, if you do not wish a file to be skipped if its output exists, use this. --ExportMarkup Value for wdExportItem - default wdExportDocumentContent. use wdExportDocumentWithMarkup to export all word comments with pdf Experimental: --skipdocswithtoc EXPERIMENTAL. Will skip any docs that contain a TOC to prevent hanging. Currently matches some false positives. Default False. --stdout Send file to Stdout after conversion. ( Does not work correctly for binary files) ERROR CODES: 200 : Invalid File Format specified 201 : Insufficient Inputs. Minimum of Input File, Output File & Type 202 : Incorrect switches. Switch requires value 203 : Unknown switch in command 204 : Input File does not exist 205 : Invalid Parameter Value 220 : Word or COM Error 221 : Word not Installed 400 : Unknown Error
The project compiles with Delphi (I use 10.3 but it should compile with most versions including XE4 & 7). The project will not compile on Linux as it uses several Windows only components such as COM and Word and Excel do not have Linux versions anyway so there would be no point.
XLSTo is now incorporated into DocTo. Previously XLSTo was a seperate EXE that was used to convert xls files to csv or pdf. This can now be done with the main
DocTo.exe by simply adding the -XL flag.
I am happy to accept any PR anyone might like to submit. If a large amount of work involved, please open an issue first to ensure the effort wont be wasted.
The main branch name in the repo is