HN Explorer

Show HN: Doxx – Terminal .docx viewer inspired by Glow (github.com)

261 points by w108bmg ↗ HN
I got tired of open file.docx → wait 8 seconds → close Word just to read a document, so I built a terminal-native Word viewer!

What it does:

* View `.docx` files directly in your terminal with (mostly) proper formatting

* Tables actually look like tables (with Unicode borders!)

* Nested lists work correctly with indentation

* Full-text search with highlighting

* Copy content straight to clipboard with `c`

* Export to markdown/CSV/JSON

Why I made this:

Working on servers over SSH, I constantly hit Word docs I needed to check quickly. The existing solutions I'm aware of either strip all formatting (docx2txt) or require GUI apps. Wanted something that felt as polished as [glow](https://github.com/charmbracelet/glow) but for Word documents.

The good stuff:

* 50ms startup vs Word's 8+ seconds

* Works over SSH (obviously)

* Preserves document structure and formatting

* Smart table alignment based on data types

* Interactive outline view for long docs

Built with Rust + ratatui and heavily inspired by Charm's [glow](https://github.com/charmbracelet/glow) package for viewing Markdown in the CLI (built in Go)!

    # Install
    cargo install --git https://github.com/bgreenwell/doxx
    
    # Use
    doxx quarterly-report.docx
Still early but handles most Word docs I throw at it. Always wanted a proper Word viewer in my terminal toolkit alongside `bat`, `glow`, and friends. Let me know what you think!

33 comments

[ 2.8 ms ] story [ 62.1 ms ] thread
treetalker
Great project! Looking forward to trying it out in my law practice.

The name causes miscues and carries negative connotations, though, on account of its homonym verb (doxxing).

[deleted]
(comment deleted)
[deleted]
(comment deleted)
greazy
Very cool project. I wish something like this for pdf files.
BrouteMinou
It looks fantastic! That's going into my toolbox that's for sure.

It's refreshing to see something that isn't another chatbot.

zipping1549
Great project. I love anything TUI.

Not so good of a name.

firesteelrain
Can you use this to basically cat the output and then you can grep the docx?

pandoc can do this

acedTrex
> claude.md in the repo

Very unfortunate

w108bmg
What an ignorant comment! I've been developing (statistical) software for 10+ years! This project would've taken me 6+ months at least, but I've been able to take the idea + some scratch code to production in a weekend.
pylotlight
Install from source with git surely cannot be your only deployment plan here?
w108bmg
Just added a more comprehensive release with a lot more install options!
ashton314
Very cool!

I did something like this with pandoc:

    pandoc -s -t man "$1" | groff -T utf8 -man | ${PAGER:-less}
Keeps a lot or formatting. My favorite way to read a README file in the terminal
3eb7988a1663
Can this interact with Track Changes at all? Reviews+Comments? Probably a rat's nest of complexity, but that is something which might interest me every once and a while.

The other thing which was not obvious - can you extract document metadata and/or hidden text elements?

porridgeraisin
Is there no image support? You can use the kitty image protocol or sixel to display them inline no?
majkinetor
This looks great, I hope we will have releases for Windows soon. It really does going to my nerves to install MS Office on new machine, and recently I stopped doing that and use Office 365 free version to view and edit docs instead, which is way worst regarding efficiency and privacy, but at least I don't have it on my machine. Its a shame there is no stripped down version of Word that lets me just view docx files and do most basic editing and commenting, that can be installed with winget in seconds. I use markdown for everything, but in enterprise environment when I send markdown to people they convert it to Word and return it back...

BTW, 8 seconds to start Word? What kind of computer are you using? Word is not performance beast but its not that slow either.

politelemon
It would be very nice if this were in a Docker image, so we don't need a go install.
Hilift
> Working on servers over SSH, I constantly hit Word docs

What?

zvr
Wonderful project; loved the speed and responsiveness.

But a humble request: please make sure that the planned "AI integration" is completely optional, not compiled-in, or, even better, a sister project ("aidoxx"?).

Having the functionality of sending the contents of a Word document to any external service will be a red flag and block adoption of this tool in many environments.

nirava
+1 to this. The AI stuff should be a different tool that I can pipe stuff into:

`doxx document.docs | doxxAI`

Even without any of the bad vibes around AI, it is just much more aesthetic and wonderful if the core doxx util was a single purpose command.

Also, it is open source so if it's sufficiently useful, someone will spin off a AI stripped down version anyways, and that'll probably gain more users/goodwill in the kind of CLI SSH dev niche market this tool is trying to fit in.

angrydingo
very cool, just discovered glow so I would like to build something similar too :)
g0ran
What an unfortunate name.
piker
Hey this looks really awesome. Super helpful for those of us who are building in the document space for debugging if nothing else. Here are a couple of other projects for you to develop with / on if you aren't already using them:

- https://github.com/mikeebowen/OOXML-Validator (if you plan on making edits, you'll want to ensure they're renderable by other Word users)

- https://marketplace.visualstudio.com/items?itemName=yuenm18.... (incredible VS code extension for debugging OOXML files)

One thing that will surprise a lot of users is how common old-style Word (.doc) files are still. For that you might consider integrating Antiword (https://github.com/grobian/antiword) if you can get comfortable with the licensing.

Be aware that styles play an important role in numbering that doesn't seem to be picked up here. So you'll want to apply the styles before calculating the numbering levels.

Over all really cool. Hit me up if you ever want to swap notes on Docx and Rust. My email is in my profile.

Keep it up!

_def
Far tangent: does anyone else feel pressured when viewing a document in google docs and it's visible that a coworker is (or could) also viewing it, and seeing your cursor etc?
bishwos
Interesting project. How much time did it take to build the project?
i_am_proteus
I have noticed many nice projects built on Rust + ratatui - many thanks to the creators and mantainers.
joshka
It's always nice to hear public thanks. :)
leephillips
Thanks for making this! It seems to work great, and will be convenient to have around.

My one feature request would be to remove, or provide a version without, the “AI” stuff.

shazbotter
Installing something named "doxx" and executing it sounds like a top ten bad idea for computer users.

Needs a new name, or a certain percentage of the audience will nope out before you even get to explain what it does.