docx2txt (http://docx2txt.sourceforge.net/) is a simple tool to generate equivalent text files from (even corrupted) Microsoft .docx documents, with an attempt towards preserving sufficient formatting and document information, and appropriate character conversions for a good text experience. Dependencies ------------ You will need to have following programs installed on your system for using this tool. Mandatory : * PERL * A commandline unzipping program that can silently extract single file from zip archive to console/standard output/pipe. Unzip, 7-Zip (7z), PKZip (pkzipc), and WinZip (wzunzip) are some such known programs that serve the purpose when invoked with appropriate command/options. How to Use ---------- You can do the text conversion in different ways depending upon your usage environment. 1. Using docx2txt.pl : a. docx2txt.pl infile.docx outfile.txt Use - as the name of output text file, to send extracted text to STDOUT, that is, console. b. docx2txt.pl file.docx OR docx2txt.pl file In both these cases output text will be saved in file.txt . Input can also be provided via STDIN (console) using - as the name of input docx file. Moreover redirection of input/output is possible with this script, making it feasible to invoke it in even more ways as illustrated below. c. docx2txt.pl < infile.docx In this case input is read from infile.docx and output is sent to STDOUT. d. docx2txt.pl < infile.docx > outfile.txt In this case input is read from infile.docx and output is sent to outfile.txt . e. cat infile.docx | ./docx2txt.pl In this case content of infile.docx is read via STDIN and output is sent to STDOUT. f. cat infile.docx | ./docx2txt.pl - outfile.txt In this case content of infile.docx is read via STDIN and output is sent to outfile.txt . Input argument in all the above cases can also be a directory holding the unzipped content of a .docx file. This feature is particulary useful if you do not have a commandline unzipping program as required in dependencies. Usage help can be obtained by giving '-h' as the first argument to the script. docx2txt.pl -h Tune your Experience -------------------- You can change following settings via docx2txt.config file that is looked for - in the current directory, - user configuration directory (APPDATA on Windows, HOME on non-Windows), and - in the system configuration directory (same directory that holds the script files on Windows, /etc or as set during installation on non-Windows), in the specified order. In case script does not find any configuration file, it continues with builtin default settings. a. Path to unzip program, and relevant command/options to be passed to it [#] b. Path to temp directory c. Newline in output text file (Unix/Dos way) d. Line width (used for short line justification) e. Showing of hyperlink along with linked text f. Twips per character, to obtain desired list indentation in text output You can also adjust representative bullet indicators in docx2txt.pl, but be careful while modifying it. [#] Unzipping Program | Relevant Command/Options ------------------+------------------------------------------------------ unzip | -p 7z | e -so -tzip pkzipc | -console -silent -translate=none -noarchiveextension wzunzip | -c Viewing the text content of Docx file in Editors and File browsers ------------------------------------------------------------------ 1. MC (Midnight Commander) ----------------------- You can add following binding in ~/.mc/bindings and view the text content of a .docx file by hitting F3 key (assuming default key mappings) after moving the cursor over concerned filename in mc pannel. # Microsoft .docx Document regex/\.(docx|DOCX|Docx)$ View=%view{ascii} docx2txt.pl %f - 2. VIm Editor ---------- You can add following lines in your ~/.vimrc to view the text content of a .docx file directly when using vim. "use docx2txt.pl to allow VIm to view the text content of a .docx file directly. autocmd BufReadPre *.docx set ro autocmd BufReadPost *.docx %!docx2txt.pl Note that above .vimrc addition will allow you to view the text content of .docx files specified as command line argument to vim, but not of those read using ":r file.docx". Please refer to http://vimdoc.sourceforge.net/htmldoc/autocmd.html for more information on autocmd. 3. Emacs Editor ------------ You can add following lines in your ~/.emacs file to view the text content of a .docx file directly when using emacs. (add-to-list 'auto-mode-alist '("\\.docx\\'" . docx2txt)) (defun docx2txt () "Run docx2txt on the entire buffer." (shell-command-on-region (point-min) (point-max) "docx2txt.pl" t t)) Be warned that with above ~/.emacs code addition, if you happen to save the buffer/file, it will overwrite the .docx file with the text content. Please explore "Filters -- making things readable:" section at http://www.emacswiki.org/emacs/CategoryExternalUtilities for more ways to view .docx file text content directly in emacs. Recovering text from corrupted .docx file ----------------------------------------- A .docx file is a zip archive of a collection of XML files. Two kind of corruptions - zip archive corruption, and component XML file(s) corruption, can cause a common Docx Reader/Viewer to fail while reading the file. The way docx2txt.pl extracts text content from .docx file, it is somewhat immune to XML corruption, and can extract reasonable text content from even corrupted XML file. As for zip archive corruption, if you have an unzipper that can fix a corrupted zip archive[#] and/or extract atleast required XML files from a corrupted zip archive[*], you are ready to extract text from the corrupted .docx file. You may temporarily need to rename .docx file as .zip file, if required by unzipper. If this unzipper can extract specific files to pipe/standard output/console, you can simply specify it in config file. Otherwise you can extract the archive content in a directory, suitably named as per your need, and specify this directory as the filename argument to the docx2txt.pl script. [#] Program Name | Example Usage --------------+------------------------------------------------------ zip | zip -FF corrupted.docx --out fixed.docx ALZipCon | ALZipCon.exe -r corrupted.zip pkzipc | pkzipc.exe -fix t.zip winrar[GUI] | Repair archive, [*] Keep broken extracted files Request ------- If you are using this work directly/indirectly for non-personal purpose(s), please inform the author about it along with relevant url(s), so that it can be mentioned on the project homepage. In case you come across some issue with it, or need a feature that can be handled in docx to text conversion, please feel free to communicate. An accompanying test .docx document depicting the issue/need and the corresponding text file generated by MSOffice with character substitution enabled (or as you would like the text file to be) will be helpful. You can track the project via http://sourceforge.net/projects/docx2txt and refer to project cvs if there have been changes since this release. Disclaimer ---------- This program includes no warranty whatsoever. It is provided "AS IS". For more information please read the COPYING document, which should be included with the package, and describes the GNU Public License, which covers docx2txt. Sandeep Kumar ( shimple0 -AT- yahoo .DOT. com )