TWINKLE(1)

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

💖 TWINKLE 💖

okay bestie, sit down, hydrate, because we're about to talk about twinkle — that's the Twinkle 1.10.0 situation, living in section 1 of your manual pages (that's User Commands, for the uninitiated ✨). it's a softphone and it's giving main character energy and i'm obsessed.

✨ SYNOPSIS ✨

twinkle [options]

that's it. that's the whole vibe. options go in, magic comes out 🦋

🎀 OPTIONS 🎀

okay so here's the whole menu, no skips, no cuts, we read every single one because that's what we do 💅

  • -c — runs it in command line interface (CLI) mode. no fancy window, just you and the terminal, lowkey iconic.
  • --share <dir> — sets the share directory. that's the whole thing, bestie, she's simple like that.
  • -f <profile> — starts up with one specific profile instead of making you pick. you will not be asked to choose a profile at startup, thank god, we love a decisive queen. the profiles you made are the .cfg files chillin' in your .twinkle directory. and yes, you can name several of them, separated by spaces. slay.
  • --force — if a lock file gets detected at startup, this overrides it and starts up anyway. it's the "i said what i said" flag fr fr.
  • --sip-port <port> — port for SIP signalling. this port overrides the port from the system settings. periodt, it wins. 👑
  • --rtp-port <port> — port for RTP. this one also overrides the port from the system settings. same energy, different protocol 🌈
  • --call <address> — tells Twinkle to call that address. and here's the cute part: if Twinkle is already running, this tells the running process to make the call instead. the address can be a full or partial SIP URI — a partial one gets completed using the info from your user profile, so you don't have to type the whole thing 🫶

you can also pass a subject by appending ?subject=<subject> to the address. obsessed.

examples, verbatim, don't @ me:

twinkle --call 123456
twinkle --call sip:example@example.com?subject=hello
  • --cmd <cli command> — tells Twinkle to run that CLI command. you can run all the commands from command line interface mode, so go off. and if Twinkle is already running, this instructs the running process to execute the CLI command instead 💫

examples again, exactly as written:

twinkle --cmd answer
twinkle --cmd mute
twinkle --cmd 'transfer 12345'
  • --immediate — this one teams up with --call or --cmd. it means the command or call happens immediately, without asking you for any confirmation. no "are you sure?" popup, no vibes check, just go 🏃‍♀️
  • --set-profile <profile> — makes <profile> the active profile. and when you use it together with --call and --cmd, the profile gets activated before --call or --cmd runs. order matters, bestie, it's a whole sequence 💜
  • --show — tells a running instance of Twinkle to show the main window and take focus. it's the "hey, look at me" flag ✨
  • --hide — tells a running instance of Twinkle to hide in the system tray. and if there's no system tray in play, then Twinkle will minimize instead. she adapts 💅
  • --help-cli [cli command] — with no cli command, this lists all the available CLI commands. with a CLI command, it prints help on that CLI command. it's the friendly tour guide 🧚
  • --version — get version information. short, sweet, does what it says on the tin 🎀

Copyright © 2005-2015 Michel de Boer and contributors http://twinkle.dolezel.info

Built with support for: ALSA, Speex, iLBC, ZRTP

Contributions, the whole roster, we're thanking everybody:

  • Werner Dittmann (ZRTP/SRTP)
  • Bogdan Harjoc (AKAv1-MD5, Service-Route)
  • Roman Imankulov (command line editing)
  • Ondrej Moris (codec preprocessing)
  • Rickard Petzall (ALSA)

and this software contains the following software from 3rd parties:

for RTP, the following dynamic libraries are linked:

Twinkle comes with ABSOLUTELY NO WARRANTY. like, none. zero. read that again, bestie 😭

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. iconic behavior tbh 🌈

🦋 SEE ALSO 🦋

the full documentation for Twinkle is maintained as a Texinfo manual. if the info and Twinkle programs are properly installed at your site, the command

info Twinkle

should give you access to the complete manual. go read it, it's giving ✨ scholarly ✨

that's the whole page, babe — Twinkle 1.10.0, dated 15 July 2016, and the page itself was born January 2016. love that for us. mwah, drink some water, bye 💖

📦 where this page comes from