DocTo

Simple command line utility for converting .doc & .xls files to any supported format such as Text, RTF, CSV or PDF

This project is maintained by tobya

DocTo & XLSTo

DocTo

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/

XLSTo

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.

Features

  1. Convert Doc/RTF/Text file to any Word SaveAs Type Doc/Text/RTF/PDF
  2. Convert XLS/XLSX/CSV file to any Excel SaveAs Type CSV/Text/PDF
  3. Convert Text/CSV file to full fledged Word or Excel format.
  4. Single File Conversion
  5. Multiple / Directory File Conversion.
  6. Delete after conversion
  7. Fire https Webhook on each conversion.

Installation

Download .exe from Release https://github.com/tobya/docTo/releases

Package Manager

Also Available for installation via Chocolatey

choco install docto

Bugs and Features

Please log an issue for any bugs, features or suggestions.

Examples

Single

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

Multiple Files and Folders

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 File after Conversion

Delete Original Files after conversion (-R) .

docto -f "C:\Dir with Spaces\FilesToConvert\" -O "C:\DirToOutput" -T wdFormatPDF  -OX .pdf -R true

Webhooks

Add a Webhook to fire on each conversion (-W)

docto -f "C:\Dir with Spaces\FilesToConvert\" -O "C:\DirToOutput" -T wdFormatPDF  -OX .pdf  -W http://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.

Use in the Wild

If you are using DocTo in the wild somewhere, please add details to this wiki page

OneDrive Conversion

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

https://webapps.stackexchange.com/questions/74859/what-format-does-word-online-use

Command Line Help

Help
Version:1.0.1.alphpa
Source: https://github.com/tobya/DocTo/
Command Line Parameters
Each Parameter should be followed by its value  -f "c:\Docs\MyDoc.doc" -O "C:\MyDir\MyFile"
Parameters markers are case insensitive. Short and Long can be used mixed.
-H  This message
  --HELP -?
-WD Use Word for Converstion (Default)
    --word
-XL Use Excel for Conversion
    --excel
-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 List Below
    --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

Extra Parameters:
--bookmarksource --pdf-BookmarkSource     
    PDF conversions can take their bookmarks from
    WordBookmarks, WordHeadings (default) or None
--donotoverwrite
    Existing files are overridden by default, if you do not wish a file to be
    skipped if its output exists, use this.
--pdf--OpenAfterExport
    When converting to pdf or xps you can choose to open the converted file
    after conversion. Default False.
    
Experimental:      
--skipdocswithtoc
    EXPERIMENTAL.  Will skip any docs that contain a TOC to prevent hanging.
    Currently matches some false positives.  Default False. 
  
  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
  220 : Word or COM Error
  221 : Word not Installed
  400 : Unknown Error
  
  COMPATIBILITY MODES:
  FROM https://msdn.microsoft.com/en-us/library/office/ff836084.aspx
  
  wdCurrent   : 65535 Compatibility mode equivalent to the latest version of Microsoft Word.
  wdWord2003  : 11    Word 2010 is put into a mode that is most compatible with Word 2003.
                      Features new to Word 2010 are disabled in this mode.
  wdWord2007  : 12    Word 2010 is put into a mode that is most compatible with Office Word   2007.
                      Features new to Word 2010 are disabled in this mode.
  wdWord2010  : 14    Word 2013 is put into a mode that is most compatible with . Features   new to
                      Word 2013 are disabled in this mode.
  wdWord2013  : 15    Default. All Word 2013 features are enabled.

Compiling

The project compiles with Delphi (I use XE4 but it should compile with most versions including 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.

Get Involved.

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.

Updates

0.7 Added support for saveas2 function (with compatibility mode) added by microsoft in Word 2010. Additional Switches. Added support for long parameters.

0.5.5 Changes made to logging. -Q and -L 0 now work correctly ensuring nothing is output to console. Must specify -G or -GL to get access to logs and errors. Also -L 10 now outputs extra as logging param is loaded first.