Show HN: Doxx – Terminal .docx viewer inspired by Glow

261•w108bmg•5mo ago

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!

Comments

treetalker•5mo ago

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).

Tmpod•5mo ago

Was thinking the same. Might be worth looking into renaming the project, to prevent situations like that for both maintainers and users.

ThreatSystems•5mo ago

I am genuinely curious, as to how this would be a solution for a law practice? How many lawyers are SSH'd into servers? Or am I being ignorant?

Eldt•5mo ago

It doesn't have to be used over SSH, some lawyers might be comfortable using the terminal for local work

btown•5mo ago

As a non-lawyer who’s nonetheless been asked to help to review internal documents en masse - the idea of a fully scriptable <50ms switch time between documents is quite appealing. AI can help with initial screening, but there are many situations where humans are asked or required to do review at scale.

treetalker•5mo ago

I hate Word but sometimes have to deal with it when I would rather just have plain text. (Among other reasons, Word is notorious for making it difficult to select text to copy and paste, especially when dealing with legal citations and quotations.) Furthermore, the structure of documents is important to understanding them, especially in the law. So it seems like it would be useful to work with the text of the documents without locking horns with M$.

Scripting uses interest me too. Perhaps pandoc will still be a better option, but I'm also a sucker for TUIs and _Charm projects!

w108bmg•5mo ago

I'm working to improve the copy/paste. Right now, you can copy everything, but not select snippets to copy/paste (ways around this, though). Hopefully have it working in the next week!

albertgoeswoof•5mo ago

This is what you’re looking for: https://tritium.legal/

treetalker•5mo ago

I saw this on HN before, but how is it for litigation?

nine_k•5mo ago

The name could rather be docc, along the lines of thicc,

Imustaskforhelp•5mo ago

Yea I like this one, I feel like they should change the name but maybe that's just my opinion and the author is free to do what they want with the project's name.

But still doxx feels like it would just get some unwarranted attention when its unnecessary and docc seems a nice enough name too.

I mean, the project seems fantastic but still the project seems quite new and I don't think that it would suffer anything from a name change.

w108bmg•5mo ago

It's 100% intentional wordplay! "Doxxing" documents by exposing their contents in the terminal instead of keeping them locked in Microsoft Word. The whole project is about "liberation from Office" so the pun felt perfect. I'm honestly not too creative so I was bouncing around with Google Gemini on some "clever" names.

rafram•5mo ago

Some people may not want to have a tool called "doxx" installed on their work machines, FWIW.

KomoD•5mo ago

This is such a non-issue, it's just a name.

If someone asks about it "It's a tool to view docx files", end of conversation

8organicbits•5mo ago

We've got `git` (an insult), `kill` (violent), `slack` (not doing work) and `fsck` (looks like fuck). Doxx seems ok to me too.

paavope•5mo ago

I've seen the `itsdangerous` [1] package (which is a dependency for lot of Python projects) raise some eyebrows several times.

[1] https://itsdangerous.palletsprojects.com/en/stable/

jahsome•5mo ago

I get the sense you've never worked under the oppresive thumb of dashboard-driven enterprise IT, heh

greazy•5mo ago

Very cool project. I wish something like this for pdf files.

ivanjermakov•5mo ago

You can always use pandoc to convert pdf to md/plaintext and print it to console.

zvr•5mo ago

Pandoc can convert to PDF, but not from PDF.

https://pandoc.org/faqs.html#how-can-i-convert-pdfs-to-other...

BrouteMinou•5mo ago

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•5mo ago

Great project. I love anything TUI.

Not so good of a name.

agnishom•5mo ago

Agree on the second part.

https://www.urbandictionary.com/define.php?term=doxx

w108bmg•5mo ago

I honestly don't get the name hate? It's 100% intentional wordplay! "Exposing" word documents in the CLI.

mionhe•5mo ago

Doxing is more than exposure. It's exposing someone's real world identity online, often with the intent to harm them. It's the harming portion that I think most people are objecting to. While I doubt most of us have enough online notoriety for us to be targeted in this kind of attack, the idea is still very uncomfortable personally.

16bytes•5mo ago

It's a very pejorative term that is used with malicious intent. You don't understand why folk find it off-putting?

What about something like mdocx?

rafram•5mo ago

If you keep having to explain why the name isn’t offensive/distasteful, it probably is (at least to a meaningful portion of the population).

jermberj•5mo ago

This should be the main reply to OP's every attempt as well.

leptons•5mo ago

Out of all the names this could have had, "doxx" is probably the absolute worst. "Wordplay" doesn't excuse bad taste. I'm not sure how many comments about it will convince you of that.

>"Exposing" word documents in the CLI.

You're trying way too hard.

alpaca128•5mo ago

> "Exposing" word documents in the CLI

Exposing contents is called a leak. Doxxing is exposure of a person's identity/address etc.

There is no wordplay here that actually fits what this tool does. This is just a very misleading name.

mxuribe•5mo ago

Hi @w108bmg i get where you're coming from...And, if your intent is to use this wonderful tool that you built for you and some small circle of friends, etc..., then the naming is of course, your choice, and you can do what you want! But, you did post it on hacker news, and you did ask for feedback. If your intent is to have this cool app be used by more users, then you should consider the feedback that you're getting here. Should all this feedback represent every single possible user? No! Let's face it, hacker news has a lot of tech-savvy users...so there's many different types of potential users not accounted for here, and so it would be good for you to get feedback from other users that you want using your app...if you want that.

This software is your baby...but if you named your baby something that possibly repels others, you should feel comfortable with that feedback going forward. i don;t mean that in a bad way, simply a fact of how humans (good or bad) respond to things. This is all simply a series of signals. What you do with that is your business of course.

By the way, have you considered a more boring name for the app like *DocSee*? :-)

goku12•5mo ago

True on both accounts. Doxxing is a traumatic experience for those who have been at its receiving end. A good project like this shouldn't be marred by a name like that.

firesteelrain•5mo ago

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

pandoc can do this

w108bmg•5mo ago

Maybe? I don't use Pandoc directly (fantastic program, but I only use it thorugh Quarto and Rmarkdown), but something like `doxx document.docx --export text | grep "search term"` should work just like `cat`+`grep`, but with better table structure and no intermediate conversion needed like pandoc.

firesteelrain•5mo ago

With pandoc you can do this I think

pandoc -t plain file.docx | grep "pattern"

koolba•5mo ago

Even better you can have pandoc output markdown.

firesteelrain•5mo ago

Which almost looks like what this terminal program is doing ?

acedTrex•5mo ago

> claude.md in the repo

Very unfortunate

btbuildem•5mo ago

And why is that? Because the logs were not hand-hewn? Source code was not crafted by the honest, simple, hard-working indigenous peoples of... wherever?

If you read through that claude.md, it's a well-organized summary of the project, touching on design, architecture, enumerating the functionality implemented so far, future goals, and more. It makes for a pretty great onboarding document for collaborators, tbh.

Have jetpack, will fly.

mikepurvis•5mo ago

I noticed this too recently, that the copilot instructions I had written up were just as suitable for importing a human.

w108bmg•5mo ago

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•5mo ago

Install from source with git surely cannot be your only deployment plan here?

w108bmg•5mo ago

Just added a more comprehensive release with a lot more install options!

ashton314•5mo ago

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•5mo ago

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•5mo ago

Is there no image support? You can use the kitty image protocol or sixel to display them inline no?

majkinetor•5mo ago

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.

jbgt•5mo ago

LibreOffice is a food alternative if you just want simple Word management.

Of course it's a big install on the other hand.

majkinetor•5mo ago

I like the typo :)

I tried it, but some documents are not shown correctly as far as I remember.

mxuribe•5mo ago

Both MS Word and Libreoffice leave me feeling bloated...so am thankful for a lighter weight offering like doxx...to help with my computing "diet"...Wait, are we still talking about food or apps? :-)

politelemon•5mo ago

It would be very nice if this were in a Docker image, so we don't need a go install.

Hilift•5mo ago

> Working on servers over SSH, I constantly hit Word docs

What?

zvr•5mo ago

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.

stavros•5mo ago

I'm usually not averse to AI in things, but I agree with you, any online functionality in a cli tool would make our security team ban a tool, and with good reason.

freedomben•5mo ago

The name of the took would certainly be ironic if they add this...

nirava•5mo ago

+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•5mo ago

very cool, just discovered glow so I would like to build something similar too :)

g0ran•5mo ago

What an unfortunate name.

piker•5mo ago

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!

xvilka•5mo ago

Instead of Antiword, maybe using LibreOffice parsers directly would solve the problem for parsing all kinds of the documents.

_def•5mo ago

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?

sjsdaiuasgdia•5mo ago

My favorite version of this is when someone is introduced to the idea that others can see when they select a range of text by seeing their selection show up on the view of the doc being presented to the video conf.

bishwos•5mo ago

Interesting project. How much time did it take to build the project?

i_am_proteus•5mo ago

I have noticed many nice projects built on Rust + ratatui - many thanks to the creators and mantainers.

joshka•5mo ago

It's always nice to hear public thanks. :)

leephillips•5mo ago

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.

xvilka•5mo ago

It would have been nice if it also parsed old DOC (and RTF) formats, maybe ODT[1] as well.

[1] https://github.com/anvie/dotext

shazbotter•5mo ago

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.

aeve890•5mo ago

I dream for the day when I can get to do anything I want without leaving the terminal. Thank you for your service.

The criticism of the project name is on point though. Horrible for searching and probably a no-no in job machine.

adultSwim•5mo ago

Thanks for making this tool. Plenty of us have similar use case to your own.

Is .docx edit support a possibility in the future?

snthpy•5mo ago

Wonderful! Thank you. Looking forward to trying this out.

Now can you do Excel next? I'm aware of [calamine](https://github.com/tafia/calamine) but that doesn't render as beautifully as doxx. Presumably a lot of the MS XML schema ontology is shared? Ideally you could just use some of their readers and add your UI flare.

Also really nice list of tools in your previous submissions. Awesome work!

w108bmg•5mo ago

Thanks for all the support and good feedback! First release is out!

https://github.com/bgreenwell/doxx/releases/tag/v0.1.1

Stories from 25 Years of Software Development

minikeyvalue

Neomacs: GPU-accelerated Emacs with inline video, WebKit, and terminal via wgpu

Show HN: Moli P2P – An ephemeral, serverless image gallery (Rust and WebRTC)

How I grow my X presence?

What's the cost of the most expensive Super Bowl ad slot?

What if you just did a startup instead?

Hacking up your own shell completion (2020)

Show HN: Gorse 0.5 – Open-source recommender system with visual workflow editor

GLM-OCR: Accurate × Fast × Comprehensive

Local Agent Bench: Test 11 small LLMs on tool-calling judgment, on CPU, no GPU

Show HN: AboutMyProject – A public log for developer proof-of-work

Expertise, AI and Work of Future [video]

So Long to Cheap Books You Could Fit in Your Pocket

PID Controller

SpaceX Rocket Generates 100GW of Power, or 20% of US Electricity

Kubernetes MCP Server

I Built a Movie Recommendation Agent to Solve Movie Nights with My Wife

What were the first animals? The fierce sponge–jelly battle that just won't end

Sidestepping Evaluation Awareness and Anticipating Misalignment

OldMapsOnline

What It's Like to Be a Worm

Don't go to physics grad school and other cautionary tales

Lawyer sets new standard for abuse of AI; judge tosses case

AI anxiety batters software execs, costing them combined $62B: report

Bogus Pipeline

Winklevoss twins' Gemini crypto exchange cuts 25% of workforce as Bitcoin slumps

How AI Is Reshaping Human Reasoning and the Rise of Cognitive Surrender

Cycling in France

Ask HN: What breaks in cross-border healthcare coordination?

Stories from 25 Years of Software Development

minikeyvalue

Neomacs: GPU-accelerated Emacs with inline video, WebKit, and terminal via wgpu

Show HN: Moli P2P – An ephemeral, serverless image gallery (Rust and WebRTC)

How I grow my X presence?

What's the cost of the most expensive Super Bowl ad slot?

What if you just did a startup instead?

Hacking up your own shell completion (2020)

Show HN: Gorse 0.5 – Open-source recommender system with visual workflow editor

GLM-OCR: Accurate × Fast × Comprehensive

Local Agent Bench: Test 11 small LLMs on tool-calling judgment, on CPU, no GPU

Show HN: AboutMyProject – A public log for developer proof-of-work

Expertise, AI and Work of Future [video]

So Long to Cheap Books You Could Fit in Your Pocket

PID Controller

SpaceX Rocket Generates 100GW of Power, or 20% of US Electricity

Kubernetes MCP Server

I Built a Movie Recommendation Agent to Solve Movie Nights with My Wife

What were the first animals? The fierce sponge–jelly battle that just won't end

Sidestepping Evaluation Awareness and Anticipating Misalignment

OldMapsOnline

What It's Like to Be a Worm

Don't go to physics grad school and other cautionary tales

Lawyer sets new standard for abuse of AI; judge tosses case

AI anxiety batters software execs, costing them combined $62B: report

Bogus Pipeline

Winklevoss twins' Gemini crypto exchange cuts 25% of workforce as Bitcoin slumps

How AI Is Reshaping Human Reasoning and the Rise of Cognitive Surrender

Cycling in France

Ask HN: What breaks in cross-border healthcare coordination?

Show HN: Doxx – Terminal .docx viewer inspired by Glow

Comments