https://github.com/dayvonjersen/chopsuey
🥡 irc client for windows
https://github.com/dayvonjersen/chopsuey
golang irc irc-client windows
Last synced: about 1 month ago
JSON representation
🥡 irc client for windows
- Host: GitHub
- URL: https://github.com/dayvonjersen/chopsuey
- Owner: dayvonjersen
- License: wtfpl
- Created: 2017-05-13T22:47:18.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2023-09-06T00:00:22.000Z (almost 3 years ago)
- Last Synced: 2025-10-24T12:44:10.609Z (8 months ago)
- Topics: golang, irc, irc-client, windows
- Language: Go
- Homepage:
- Size: 538 KB
- Stars: 10
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
[](#contributing-and-feedback)
#  chopsuey
an IRC client for Windows
contents:
[Downloads](#download) |
[Features](#features) |
[Known Issues](#known-issues) |
[/commands](#list-of-commands) |
[Keyboard Shortcuts](#keyboard-shortcuts) |
[Building from Source](#building-from-source) |
[Contributing](#contributing-and-feedback)
> windows classic, `hemisu-light` theme, font: Hack 9pt
> aero, `hemisu-dark`, ProfontWindows 9pt
> multi-line tabs, borderless and transparent window
### Download
- ## [LATEST VERSION: 0.7[DELTA] Windows 64-bit (x86_64) :point_left:](https://github.com/dayvonjersen/chopsuey/releases/download/0.7DELTA/chopsuey-v0.7-DELTA.day.zip)
- (*no win32 build sorry*)
##### Previous Releases:
- [0.7[GAMMA]](https://github.com/dayvonjersen/chopsuey/releases/download/0.7GAMMA/chopsuey-v0.7-GAMMA.tso.zip): works pretty well until you connect to > 1 network 💥
- [0.7[BETA]](https://github.com/dayvonjersen/chopsuey/releases/download/0.7BETA/chopsuey-v0.7-BETA.tso.zip): "try not to crash... try not to crash..." \*crashes a lot\*
- 0.7[PRE-ALPHA]: we don't talk about it
### Getting Started
Download the zip file and extract the contents. Open the `chopsuey` folder you
just created and double-click on the `.exe` file with an icon of a chinese takeout box.
Then in the window that just opened use your keyboard and:
- type `/server irc.rizon.net +6697` and press `Enter`
- type `/join #/g/punk` and press `Enter`
- type `tso: this is great I love this client so much thank you <3` and press `Enter`
### Features
- lightweight, fast, free
- no input lag when typing
- everything you need, nothing you don't
- themes
- very basic scripting
- see documentation for `/script` below
### Known Issues
>See [TODO.txt](https://github.com/dayvonjersen/chopsuey/blob/master/TODO.txt)
### List of Commands
#### /connect
reconnect to server (if disconnected) (specify with **/server**)
#### /disconnect
disconnect from server and do not try to reconnect
#### /quit
disconnect from server and close all associated tabs (sends quit message)
#### /reconnect
disconnect and reconnect to server (specify with **/server**)
#### /server [host] [+][port (default 6667, ssl 6697)]
open a connection to an irc network e.g. `/server irc.example.org`
to use ssl prefix port number with + e.g. `/server irc.example.org +6697`
#### /clear
remove all text from the current buffer
#### /close [part or quit message]
closes current tab with optional part or quit message
if on a channel, same as **/part**
if on a server same as **/quit**
#### /ctcp [nick] [message] [args...]
send a CTCP message to nick with optional arguments
#### /join [#channel]
attempt to join a channel, opens a new tab if successful
#### /kick [nick] [(optional) reason...]
remove a user from a channel (if you have op)
#### /list
opens a tab with all the channels on the server in a sortable table view
double click on a channel to try to join it
#### /me [message...]
\*tso slaps you around with a big trout\*
#### /mode [#channel or your nick] [mode] [nicks...]
set one or more modes for a channel or one or more nicks
#### /msg [nick] [message...]
opens a new tab and send a private message
#### /nick [new nick]
change your handle
#### /notice [#channel or nick] [message...]
sends a NOTICE. *please dont send NOTICEs to channels...*
#### /part [message...]
leave a channel with optional message (**and currently closes the tab but I'm going to change this in the future**)
#### /rejoin
join a channel you have left (because of having been disconnected, kicked or having parted
#### /topic [new topic...]
set or view the topic for the channel if you have permission to do so
#### /version [nick]
find out what client someone is using
#### /whois [nick]
send a whois query to server
#### /away [message]
mark yourself as being (Away)!
#### /unaway
announce your triumphant return
#### /help [command]
`/help` produces a list of all available commands with a brief summary of their usage
`/help [command]` shows usage about a specific command
#### /exit
exits the application
#### /script [file in `scripts/`] [args...]
run an external program and send its output as a message in the current channel or private message tab
See examples in [scripts/](https://github.com/dayvonjersen/chopsuey/tree/master/scripts)
>**NOTE**(tso): no ability to hook into irc or client state/events...yet
recognized filetypes: (**iff you have the associated interpreter installed on your system**):
| interpreter | extension |
|--------------|-----------|
| go run | `.go` |
| php | `.php` |
| perl | `.pl` |
| python | `.py` |
| ruby | `.rb` |
| bash | `.sh` |
#### /call [file in `scripts/`] [args...]
alias of `/script`
#### /register [alias] [script file]
alias a script to a command you can call directly e.g.
```
/register mycommand cool_script.pl
/mycommand hey guys
```
is synonymous with:
`/script cool_script.pl hey guys`
#### /unregister [alias]
unalias a command registered with `/register`
#### /theme [file in `themes/`]
change colors
#### /font [font name that might have spaces] [font size]
change font (*destroys previous text colors in buffer currently*)
#### /palette
### Keyboard Shortcuts
#### application
- `ctrl+q` exit application
- `shift+tab` toggle window border
- `f2` make window more transparent (enables transparency)
- `f3` enable/disable transparency
- `f4` make window less transparent (enables transparency)
#### tab navigation
- `ctrl+t` opens a new empty server tab. use `/server` to connect
- `ctrl+tab` changes focus to the tab on the right
- `ctrl+shift+tab` changes focus to the tab on the left
- `ctrl+f4` and `ctrl+w` close the current tab (if a server, it will close all associated tabs as well)
#### text formatting
- `ctrl+k` inserts color code control character. specify colors with numbers e.g.
`[ctrl+k]4this text is red`
`[ctrl+k]0,4this text is white with a red background`
| color | number |
|-----------|--------|
| White | 0 |
| Black | 1 |
| Navy | 2 |
| Green | 3 |
| Red | 4 |
| Maroon | 5 |
| Purple | 6 |
| Orange | 7 |
| Yellow | 8 |
| Lime | 9 |
| Teal | 10 |
| Cyan | 11 |
| Blue | 12 |
| Pink | 13 |
| DarkGray | 14 |
| LightGray | 15 |
- `ctrl+b` insert bold control code character. insert again to toggle.
`[ctrl+b]this will be bold[ctrl+b] this won't` == **this will be bold** this won't
- `ctrl+i` insert italic control code character. insert again to toggle.
`[ctrl+i]this will be italic[ctrl+i] this won't` == *this will be italic* this won't
- `ctrl+u` insert underline control code character. insert again to toggle.
`[ctrl+u]this will be underlined[ctrl+u] this won't` == (github markdown doesn't have underline)
- `ctrl+s` insert strikethrough control code character. insert again to toggle.
`[ctrl+s]this will be strikethrough[ctrl+b] this won't` == ~~this will be strikethrough~~ this won't
- `ctrl+0`: reset formatting to default
### Building from Source
>**NOTE**(tso): This is for **64-bit windows-only**.
It might compile on other systems if you set `GOOS` and `GOARCH`
but it won't run. I have not tested it in wine or on ReactOS or any version of
Windows other than 7SP1.
```
mkdir -p $GOPATH/src/github.com
cd !:2
git clone git@github.com:dayvonjersen/chopsuey
cd chopsuey
go get github.com/lxn/walk
go get github.com/fluffle/goirc
go get github.com/akavel/rsrc
go get github.com/maruel/panicparse/cmd/pp
go get github.com/kr/pretty
make icon
make
```
If that doesn't work [tell me about it](mailto:tso@teknik.io?Subject=it%20doesnt%20work).
### Contributing and Feedback
If you want to help me make this better [here's my TODO list](https://github.com/dayvonjersen/chopsuey/blob/master/TODO.txt).
You can also `git grep` for these tags: `NOTE` `TODO` `FIXME` `HACK` `WTF`
Feel free to [open an issue]() or [submit a pull request]() to start a discussion.
I welcome any and all constructive criticism and feedback. [E-mail me](mailto:tso@teknik.io?Subject=sup) or leave me a message on IRC (I'm tso on [Rizon](irc://irc.rizon.net:6697/) and tzo [freenode](irc://irc.freenode.net:6697/))
I'll try to respond if I'm awake and my client doesn't crash.