TEXWORKS(1)

💖 TEXWORKS(1) 💖

okay bestie, so this is the manual page for texworks, living in the General Commands Manual section of your system, and honestly? she's iconic. let's get into it ✨

---

✨ NAME ✨

texworks — a simple TeX front-end program 🎀

---

🌸 SYNOPSIS 🌸

texworks [OPTIONS] [FILES]

like, you give her some options, you give her some files, she goes. that's the whole vibe 💅

---

🦋 DESCRIPTION 🦋

so TeXworks is an environment for authoring TeX documents — and yes that means LaTeX, ConTeXt, etc etc, all of it, no cap 🫶. it's got:

• a Unicode-based, TeX-aware editor ✏️
• an integrated PDF viewer 📄
• a clean, simple interface that is literally accessible to casual and non-technical users

it was inspired by Dick Koch's award-winning TeXShop program for Mac OS X — the one that made quality typesetting through TeX accessible to a way wider community of users, without a technical or intimidating face 😌✨. and the whole goal of TeXworks is to deliver a similarly integrated, easy-to-use environment for users on other platforms, especially GNU/Linux and Windows. periodt. 💖

---

💅 OPTIONS 💅

• --help, -? — display a short overview over all command line options. she's giving helpful, she's giving overview 🌈
• --position=, -p — open the next specified file at the given position (line or page). very "take me to the exact spot" of it all 📍
• --version, -v — display version information. pop off, tell me who you are 👑

---

🎀 ENVIRONMENT 🎀

these are the environment variables, bestie, and they all start with TW_ because branding ✨

• TW_INIPATH — overrides the location of the preferences file.
• TW_LIBPATH — overrides the location of the additional configuration and library files.
• TW_DICPATH — overrides the location of dictionary files.
• TW_HELPPATH — overrides the location of help files.
• TW_PLUGINPATH — overrides the location of plugins.

lowkey obsessed with how tidy that list is 🧚

---

🍓 FILES 🍓

• ~/.config/TUG/TeXworks.conf — text file to store the preferences. your settings live here, bestie 🏠
• ~/.TeXworks/* — additional configuration and library files (e.g. for auto completion, templates, etc.). templates?? auto completion?? we love a supportive folder 🥰
• /usr/local/bin/texworks-setup.ini — setup file to override the location of the files mentioned above (e.g. for enabling portable operation). this is your "take me anywhere" era 🧳

---

🔥 SEE ALSO 🔥

• TeXworks homepage: https://tug.org/texworks/
• TeXworks development: https://github.com/TeXworks/texworks

iykyk 💜

---

😭 BUGS 😭

if you find a bug, please report it at https://github.com/TeXworks/texworks/issues

bestie do NOT suffer in silence. the devs want to know. go tell them. it's not snitching, it's contributing 💀🫶

---

👑 AUTHORS 👑

Stefan Löffler, Jonathan Kew, Charlie Sharpsteen, and others 🌟

(the "and others" is doing so much heavy lifting and honestly? respect.)

---

🌈 COPYRIGHT 🌈

Copyright (C) 2007-2026 Stefan Löffler, Jonathan Kew, Charlie Sharpsteen

License GPLv2+: GNU GPL (version 2 or later) https://www.gnu.org/licenses/gpl.html

This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

okay so the NO WARRANTY part is in all caps for a reason, bestie — it means exactly what it says. no take-backs, no guarantees, read it and weep (affectionately) 💖

---

and that's the whole page, fr fr. this came to you straight from the General Commands Manual, footer reading TEXWORKS(1) like a little signature at the bottom of the letter. go typeset something gorgeous, main character 💅✨🎀