TSOCKS(1)

📦
version 1.8beta5 · 2 versions
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 TSOCKS(1) — the tsocks manual, bestie edition 💖

okay so real talk: this is the tsocks page from the General Commands Manual, section 1. It's a little shell wrapper, and it's about to make your SOCKS proxy dreams come true. no cap. 🦋

✨ NAME ✨

tsocks — a shell wrapper that simplifies using the tsocks(8) library, so your app can go through a SOCKS proxy transparently. like, the app doesn't even know. it's giving invisible cloak energy. 💅

🌸 SYNOPSIS 🌸

tsocks [application [application's arguments]]
or tsocks [-on|-off]
or tsocks

🎀 DESCRIPTION 🎀

tsocks is the lil' middleman between the tsocks library and the application that you want to run socksified. that's the whole job. it's the group-chat admin of your network calls. 👑

🫶 OPTIONS 🫶

  • [application [application's arguments]] — runs the application exactly as you specified it, but with the environment (LD_PRELOAD) set up so that tsocks(8) will transparently proxy SOCKS connections inside that program. the app is literally none the wiser. iconic behavior. ✨
  • [-on|-off] — this one adds or removes tsocks(8) from the LD_PRELOAD environment variable. and when tsocks(8) is chillin' in that variable, every application you execute gets automatically socksified. so powerful. 😭
⚠️ heads up bestie: if you want to use this function, you HAVE to source the shell script from yours, like this: "source /usr/bin/tsocks" or ". /usr/bin/tsocks". no sourcing, no vibes.

Examples, because i love you:

  • ". tsocks -on" — add the tsocks lib to LD_PRELOAD (don't forget the leading dot! fr fr, the dot matters)
  • ". tsocks -off" — remove the tsocks lib from LD_PRELOAD (don't forget the leading dot!)
  • [-show|-sh] — shows you the current value of the LD_PRELOAD variable. a little peek behind the curtain. 🫣
  • <without any argument> — creates a new shell with LD_PRELOAD including tsocks(8). fresh shell, socksified shell, main character shell. 🌈

👀 SEE ALSO 👀

tsocks.conf(5) tsocks(8)

go read those too, they're part of the lore. 💜

💌 AUTHOR 💌

This script was created by Tamas SZERB <toma@rulez.org> for the debian package of tsocks. It (along with this manual page) have since been adapted into the main tsocks project and modified. a true legend, honestly. 🎀

and that's the whole page, bestie 💖 this one came from the TSOCKS(1) manual in the General Commands Manual, sourced straight from the tsocks project's own page. ty for reading, mwah 🫶

📦 where this page comes from