[RELEASE] Communiqué 8 Telegram Client

[Imperium Anglorum]

Communiqué

---

Communiqué is a simple open-source way to send telegrams through the Telegram API. It is built using Java (you will need an up-to-date version of Java), so it will probably run on your home computer!

It has two versions, Communiqué-proper and Marconi, a GUI and a CLI respectively. Marconi is designed to run headless and will only run if you provide it with a proper Communiqué configuration file (which are easily generated by saving using Communiqué itself).

It is designed on the open-source JavaTelegram library (which I also build and maintain) and is open for other programmers to extend and build off.

If you would like support, please include as much information as possible, like the code page where you listed your recipients and any log information that can be provided. Do not publicise your secret key or client key. Also, since this thread is not actively monitored, please post here and send me a telegram.

Screenshots

---

History

---

In campaigning for World Assembly resolutions, I was constantly stuck between the idea of using lots and lots of money for telegram stamps or doing a manual campaign. Eventually, I decided that enough was enough, and built a program to do it for me. After a few friends in the World Assembly asked for some assistance on campaigning for their own resolutions, I decided to publish this personal tool of mine and build a GUI and CLI wrapper around it.

That said, the history of this program is entirely in the World Assembly, so focus was put on building things which are helpful for campaigns. Due to the failure of NS++'s recruitment system, I put some effort into rebuilding the recruitment part in the program, through which I have already sent 12 000 telegrams in my capacity as Delegate of Europe (as of 22 September 2016)

I am always looking for more Java developers to help on the project, add features, and assist in maintenance. Bug reports are also always welcome! Send me a telegram and view my Github profile!

This program is a product of Europe and the official telegram client of the region Nordic Council. I would also like to give my thanks to Tinfect and Krypton Nova for their invaluable assistance in bug reporting issues in Communiqué! My hats off to them.

Links

---

Download Here
Download Communiqué and Marconi, the GUI and CLI clients, here. Communiqué 8 requires Java 9. The last Java 8 release is Communique 7. Scroll down the releases tab to find the appropriate download.

Documentation
Learn how to use Communiqué and Marconi here.

Bug Reports
Report bugs here and send us a screenshot (and if you're really good, a stack trace). You can also report bugs and ask for assistance in this thread!

Communiqué interfaces with the Java logging system for much of its logging. You can view runtime logs if you start Communiqué from the command line (at least, for Unix and Unix-like operating systems) with executing the following, so long as you are in the Communique JAR's directory:

Code: Select all

java -jar Communique_7.jar

[Ever-Wandering Souls]

I'd be more than happy to link this in my API TG guide if you'd like, either as soon as I dig up a working key and try it myself, or get a few other people chiming in that they can get it working for themselves

[Ever-Wandering Souls]

A note and a question-

Note: Unless you have a way to adjust the rate limit on the user end (not seen in reading the instructions so far), you should specifically have a note *not* to use this for recruitment -

The Telegrams API imposes an additional rate limit:

Recruitment TGs: 1 telegram per 180 seconds

Non-recruitment TGs: 1 telegram per 30 seconds

Ergo, if you have this hard-set to a rate limit of 30 seconds (as is appropriate for all other types of TG), any user trying to use this to recruit will run into an issue there.

---

Question: Out of curiosity, where is it noted that you can only TG any given nation once for any given proposal? I've been looking around the forums, rules, and more for a good half hour now, and have yet to find that written anywhere. I'm also fairly certain I've received multiple telegrams from the same nation - and not just an "approve," then a "vote for!' I'm thinking like the WSA - pretty sure I got 2-4 TG's from bitely on that one. There's a hard-coded version for recruitment tg's - you can only hit any given nation once in a given period for a given region, and further attempts to won't go through, period, but I've never encountered such a regulation for campaigns. I could definitely be wrong, but that's why I'm curious

[Tinfect]

Note: Unless you have a way to adjust the rate limit on the user end (not seen in reading the instructions so far), you should specifically have a note *not* to use this for recruitment -

As a user of Communique myself, I can confirm that it does look to have a setting for Recruitment. While you cannot adjust the timing yourself, in all screenshots Imperium Anglorum has provided, you can see a checkbox labeled Recruitment. Having accidentally tried to use that setting for WA campaigning in the past, I can also confirm that it does, in fact, work.

[Imperium Anglorum]

Note: Unless you have a way to adjust the rate limit on the user end (not seen in reading the instructions so far), you should specifically have a note *not* to use this for recruitment -

As a user of Communique myself, I can confirm that it does look to have a setting for Recruitment. While you cannot adjust the timing yourself, in all screenshots Imperium Anglorum has provided, you can see a checkbox labeled Recruitment. Having accidentally tried to use that setting for WA campaigning in the past, I can also confirm that it does, in fact, work.

I then put in an estimator for the time necessary to send off the telegrams specified, so people can tell whether they checked the Recruitment box or not (aka: whether it is ridiculously long or not). But that was a few versions ago.

Question: Out of curiosity, where is it noted that you can only TG any given nation once for any given proposal? I've been looking around the forums, rules, and more for a good half hour now, and have yet to find that written anywhere. I'm also fairly certain I've received multiple telegrams from the same nation - and not just an "approve," then a "vote for!' I'm thinking like the WSA - pretty sure I got 2-4 TG's from bitely on that one. There's a hard-coded version for recruitment tg's - you can only hit any given nation once in a given period for a given region, and further attempts to won't go through, period, but I've never encountered such a regulation for campaigns. I could definitely be wrong, but that's why I'm curious

Not a problem. Just make another configuration file. The initial reason I put the function in was so I didn't send the same telegram to Delegates twice (because Delegates hate that).

[Ever-Wandering Souls]

If it's a personal choice, then the section of your tutorial that states

Because NationStates has quite stringent spam rules which state that no nation may send out more than one campaign telegram for their proposal to the same person, Communiqué is built to track your recipients and prevent any such problems.

Is both non-factual and misleading.

[Imperium Anglorum]

If it's a personal choice, then the section of your tutorial that states

Because NationStates has quite stringent spam rules which state that no nation may send out more than one campaign telegram for their proposal to the same person, Communiqué is built to track your recipients and prevent any such problems.

Is both non-factual and misleading.

Then I'll change it. However it is, quite clearly, I am under the impression that it a factual statement. Would be best to get clarification on the matter.

[Bears Armed]

Question: Out of curiosity, where is it noted that you can only TG any given nation once for any given proposal? I've been looking around the forums, rules, and more for a good half hour now, and have yet to find that written anywhere.

It might not specifically be written down (in which case it s probably should be added to the sticky about GA rules), but it's one aspect of how Mods have generally interpreted the rule against 'Excessive Pimping'.

[Mousebumples]

Question: Out of curiosity, where is it noted that you can only TG any given nation once for any given proposal? I've been looking around the forums, rules, and more for a good half hour now, and have yet to find that written anywhere.

It might not specifically be written down (in which case it s probably should be added to the sticky about GA rules), but it's one aspect of how Mods have generally interpreted the rule against 'Excessive Pimping'.

For the record, it hasn't been enforced as of late. There have been a LOT of back-and-forth telegrams (mostly on the SC side, granted), and while it has been reported, group-mod determination was that so long as the TG was tagged as "Campaign" it wasn't actionable.

I've never seen that rule actually enforced during my time as a mod, so that might have been phased out when the new TG system was implemented.

[Imperium Anglorum]

It might not specifically be written down (in which case it s probably should be added to the sticky about GA rules), but it's one aspect of how Mods have generally interpreted the rule against 'Excessive Pimping'.

For the record, it hasn't been enforced as of late. There have been a LOT of back-and-forth telegrams (mostly on the SC side, granted), and while it has been reported, group-mod determination was that so long as the TG was tagged as "Campaign" it wasn't actionable.

I've never seen that rule actually enforced during my time as a mod, so that might have been phased out when the new TG system was implemented.

So... we can send more than one telegram? Takes the telegram car for a ride, drives off into the distance at 150 miles per hour.

[Sierra Lyricalia]

So... I'm probably doing something grossly dumb or wrong, but it feels like there's some kind of configuration file missing from the posted version. When I run it I get a whole bunch of error messages like this:

Code: Select all

Compile "C:\Program Files (x86)\Java\jdk1.8.0_65\Communique-master\src\com\git\ifly6\communique\Communiqué.java" with Java-Compiler
C:\Program Files (x86)\Java\jdk1.8.0_65\Communique-master\src\com\git\ifly6\javatelegram\JTelegramLogger.java:5:1: error: class, interface, or enum expected
<!DOCTYPE html>
^
C:\Program Files (x86)\Java\jdk1.8.0_65\Communique-master\src\com\git\ifly6\javatelegram\JTelegramLogger.java:6:22: error: <identifier> expected
<html lang="en" class="">
                     ^
C:\Program Files (x86)\Java\jdk1.8.0_65\Communique-master\src\com\git\ifly6\javatelegram\JTelegramLogger.java:6:23: error: illegal start of type
<html lang="en" class="">
                      ^
C:\Program Files (x86)\Java\jdk1.8.0_65\Communique-master\src\com\git\ifly6\javatelegram\JTelegramLogger.java:6:25: error: <identifier> expected
<html lang="en" class="">
                        ^
...
...
100 errors



No doubt there's something utterly hilarious I'm doing wrong. Probably stumbling over the knowledge curb that's there to weed out anyone under the bar of 1% more technically sophisticated than me. However, I'd like to learn, if not to walk, at least to crawl over this particular obstacle. Thanks!

[Imperium Anglorum]

So... I'm probably doing something grossly dumb or wrong, but it feels like there's some kind of configuration file missing from the posted version. When I run it I get a whole bunch of error messages like this:

Code: Select all

Compile "C:\Program Files (x86)\Java\jdk1.8.0_65\Communique-master\src\com\git\ifly6\communique\Communiqué.java" with Java-Compiler
C:\Program Files (x86)\Java\jdk1.8.0_65\Communique-master\src\com\git\ifly6\javatelegram\JTelegramLogger.java:5:1: error: class, interface, or enum expected
<!DOCTYPE html>
^
C:\Program Files (x86)\Java\jdk1.8.0_65\Communique-master\src\com\git\ifly6\javatelegram\JTelegramLogger.java:6:22: error: <identifier> expected
<html lang="en" class="">
                     ^
C:\Program Files (x86)\Java\jdk1.8.0_65\Communique-master\src\com\git\ifly6\javatelegram\JTelegramLogger.java:6:23: error: illegal start of type
<html lang="en" class="">
                      ^
C:\Program Files (x86)\Java\jdk1.8.0_65\Communique-master\src\com\git\ifly6\javatelegram\JTelegramLogger.java:6:25: error: <identifier> expected
<html lang="en" class="">
                        ^
...
...
100 errors



No doubt there's something utterly hilarious I'm doing wrong. Probably stumbling over the knowledge curb that's there to weed out anyone under the bar of 1% more technically sophisticated than me. However, I'd like to learn, if not to walk, at least to crawl over this particular obstacle. Thanks!

The posted version on the GitHub releases here should be directly executable (for Communiqué) using Java with a double-click on the Jar file. The error you've posted would only occur in compilation of the source file, which isn't necessary, as it's already been compiled. The error message basically says that it isn't a valid file Java source file whilst citing what appears to be HTML, so something is going on with the manner in which it is being executed.

[Sobluruk]

When running this from command line does it need to be run from windows or Linux?

[Imperium Anglorum]

When running this from command line does it need to be run from windows or Linux?

Because of the Java virtual machine, it should be executable from the command line using 'java -jar Marconi.jar'. However, I do not have a Windows machine, so I have never tested it on that platform. If you do test Marconi on that platform, I would be very happy to address any platform-specific issues that arise.

[Sierra Lyricalia]

So... I'm probably doing something grossly dumb or wrong, but it feels like there's some kind of configuration file missing from the posted version. When I run it I get a whole bunch of error messages like this:

Code: Select all

Compile "C:\Program Files (x86)\Java\jdk1.8.0_65\Communique-master\src\com\git\ifly6\communique\Communiqué.java" with Java-Compiler
C:\Program Files (x86)\Java\jdk1.8.0_65\Communique-master\src\com\git\ifly6\javatelegram\JTelegramLogger.java:5:1: error: class, interface, or enum expected
<!DOCTYPE html>
^
C:\Program Files (x86)\Java\jdk1.8.0_65\Communique-master\src\com\git\ifly6\javatelegram\JTelegramLogger.java:6:22: error: <identifier> expected
<html lang="en" class="">
                     ^
C:\Program Files (x86)\Java\jdk1.8.0_65\Communique-master\src\com\git\ifly6\javatelegram\JTelegramLogger.java:6:23: error: illegal start of type
<html lang="en" class="">
                      ^
C:\Program Files (x86)\Java\jdk1.8.0_65\Communique-master\src\com\git\ifly6\javatelegram\JTelegramLogger.java:6:25: error: <identifier> expected
<html lang="en" class="">
                        ^
...
...
100 errors



No doubt there's something utterly hilarious I'm doing wrong. Probably stumbling over the knowledge curb that's there to weed out anyone under the bar of 1% more technically sophisticated than me. However, I'd like to learn, if not to walk, at least to crawl over this particular obstacle. Thanks!

The posted version on the GitHub releases here should be directly executable (for Communiqué) using Java with a double-click on the Jar file. The error you've posted would only occur in compilation of the source file, which isn't necessary, as it's already been compiled. The error message basically says that it isn't a valid file Java source file whilst citing what appears to be HTML, so something is going on with the manner in which it is being executed.

Thanks, I'll have another go at it next time I need to run a campaign.

[Plebmerica]

y u no readme.md?

[Imperium Anglorum]

y u no readme.md?

I dunno, mate, maybe because it's already been there for ages? Apologies on how this has taken absolutely forever to respond. Apparently, the email reminder system is broken.

[The Blaatschapen]

y u no readme.md?

I dunno, mate, maybe because it's already been there for ages? Apologies on how this has taken absolutely forever to respond. Apparently, the email reminder system is broken.

The email reminder system was recently removed by [v].

viewtopic.php?f=15&t=369536

[Krypton Nova]

I'm running Marconi 4 on a Linux server, Java(TM) SE Runtime Environment (build 1.8.0_91-b14), and it works perfectly for me except when I use tags. Or at least, when I try to use "recruitment:new". It does work when I use nation names.

Are these keys correct? (censored), (censored), 14716699 [Yes] or [No]? Is the current recruitment flag (true) set correctly? [Yes] or [No]? Is the current randomisation flag (false) set correctly? [Yes] or [No]? recruitment:new

This will take 0d:0h:3m:0s to send 1 telegrams.
Are you sure you want to send to these recipients? [Yes] or [No]?
[2016/06/08 22:28:16] Failed to queue delivery to: recruitment:new, 1 of 1. IO Exception.
[2016/06/08 22:28:16] API Queries Complete.

# Communiqué Configuration File. Do not edit by hand.
# Produced at: 2016/06/08 22:28:16
# Produced by version 4

version=4
client_key=-censored-
secret_key=-censored-
telegram_id=-censored-
isRecruitment=true
randomSort=false
recruitment:new

Have I missed a specific way of using tags, or is this particular tag perhaps not supported? If so, how would I go about recruitment?

Thanks in advance

[Imperium Anglorum]

Censor your client key.

Use 'world:new', not 'recruitment:new'. Though, I may change that when I expand the recruitment centred code.

You can view the parsing structure here:
https://github.com/iFlyCode/Communique/ ... arser.java

[Krypton Nova]

Censor your client key.

Use 'world:new', not 'recruitment:new'. Though, I may change that when I expand the recruitment centred code.

Ah, it works now, thanks for your time!

[Floor 448]

Censor your client key.

Use 'world:new', not 'recruitment:new'. Though, I may change that when I expand the recruitment centred code.

Ah, it works now, thanks for your time!

You still need to censor the client key/sekrit key in the config

[Imperium Anglorum]

Due to concerns regarding Linux and the fact that there is no JavaFx implementation in OpenJDK, I'm working on moving the entire codebase back to Swing in version 5. It will also add some more helpful features. Full release is predicated upon the time when I get around to completing the recruitment module (which I haven't even started upon), so it'll be in pre-release for a long time.

[Imperium Anglorum]

This is a list of the current Delegates which have opt-ed out to receive WA campaign telegrams. Simply copy and paste this to the bottom of your recipients list if you are campaigning to automatically filter all of them out.

Code: Select all

/the lendol archipelago
/bundesvoe
/drakorvanyia
/ramdon
/cheruba
/steelhand grimnn
/norada
/mean774
/newfound america
/scrivneria
/ventelia
/dazchan
/free states of canada
/slavic bloodia
/cipress
/the free and independent
/yermaney
/bro cookie
/cazzador
/malson
/konstantinus
/ekit
/st oz
/muzztopia
/soviet confederacy of america
/parkplace
/brunelian bg advocates
/valorono
/allinburg
/khanatah
/whovian tardisia
/bearnation
/codsqueaks
/tarnen
/montesardo-east adanzi
/kandamia
/franquebec
/raavistya
/gum gum danc
/carlovia
/sunnycorp
/bananamancy
/west-flanders
/jowowwo
/atrocia
/morombe
/hydroponic nation
/arsala
/the new great britian
/trojan queens
/avendonia
/bubblie4u
/jessonia
/volesclion
/arumdaum
/pueros
/the holy empire of steel
/kwabena kingdom
/zavina
/zurmania
/architeuthis
/the united nations of true korea
/salebra
/grenartia
/turmenista
/lothaythien
/greater new finland
/evilhammyland
/sutrasante
/dekarta
/percy j pickleface
/ainin
/new oyashima
/tiroladinien and the litorale
/the glorious land of astros
/halling
/finmany
/antipodal alternia
/the asian archipelago envoy of fengjie
/vatsamoltoplandia
/the enclave-east
/alvenheim
/2018 colfaxala
/fiscis
/dem reptilians of congo
/odazdan
/zatak
/old corcra
/england united
/az island
/sheng china
/funiverse
/the northern united american republic
/lavendertopia
/qandaristania
/louisadam
/razonica
/crystal palais
/the mejobsworth
/aspergards
/the sapphiros islands
/nova sylva
/wabacha
/vildjun
/chuukango
/cimpl
/bolshevikstan
/the great loey
/montage parody
/parlmone
/pninograd
/constantine lambros
/the reunited provinces of nofa
/holynus
/magonia
/clearly upsettizens
/camicon
/leninkrav
/the media
/the united states of russell
/my h00d
/telemarcia
/kyrbekistan
/falkrenath
/yissing scalies
/vernafer
/spanish micronesia
/ovisia
/tyronian socialist state
/nalugaria
/skothafjordur
/stormwrath
/troll hi
/deutcherika
/davincia
/blehemo
/bartierchen
/greater izalith
/superdarioland
/jumalariik
/heritick farmland
/maniona
/lavochkin
/falcania
/grand britaria
/the pink feather
/lunatallytic
/crsia
/victtorya
/locrya
/amwestheim
/lamoni
/murgonea
/westnesia
/ganskeland
/jordbruksland
/halleon
/lesbatopia
/the voltarum
/svarttjern
/eristia
/agalatine
/kikuta
/yougopotamia
/auremena
/anduz
/jereathiel of jedmathia
/new orcheria
/mirawh
/commonwealth of pennsylvania
/xenathon
/kytland
/the reverends
/united christian
/united german regions
/bomb co
/areanir
/mekrovia
/alt-preussen
/ceffyltir
/the lleyn peninsula
/stalhreich
/the conez imperium
/primordial luxa
/the mellos
/hlaalu morrowind
/awakened alexandria
/bone fort
/east niphilate
/sonicellia
/sensai
/cokikho
/scottian commonwealth
/the hawaiian joltz
/heku
/phoenix coalition
/macro cosmos
/dephire
/preis
/topekarl
/communist volkstrad
/pierconium
/ascoobis
/ancient free and accepted masons
/lektropia
/eldrahar
/the united states under morisey
/the jobias empire
/austropia
/waspeaters
/clemsonaea
/chung-hwa
/gretial
/adrobia
/carolina alliance
/sneaky bastards
/steampunkfish
/dewritolia
/nilslandia
/frekant
/stad
/suroth
/ioavollr
/karolingia
/alizeria
/the free state of feroxia
/karsopolis
/omahina
/nytoland
/lazurania
/grand russian federation
/new uden
/santana tucuruvi
/vvos
/dagnia
/jasque
/brunswick and nassau
/arkotania
/yeagerland
/mushstashia
/walgreens
/capisaria
/bongara
/vacarian
/emperatium drakonicum
/morituram
/ertae
/coretettor
/zenerra
/serrated shield
/ossoria
/honkmother
/striton
/lawattsia
/googolsia
/autonomous columbia
/capitalizt abidawe
/the holy empire of san marino
/nephara
/meow zao
/kilobugya
/rosenesse
/sith empire m2
/caucasaulia
/madame du barry
/authorious
/aksun
/pixylvania
/van luxemburg
/free atlanticans
/merlinton
/grarrgtopia
/new hayesalia
/ijzerland
/phokaia
/darthstassen
/susria
/guppychal
/rizza
/saphlua
/lipitehsys
/mars roma
/call of potato
/straphangers
/sfr of yugoslavia
/beanboozled
/boros guild
/bavernia
/azbackastan
/soyghuristan
/chalakudy
/apiatica
/hatay
/cayo arcadio
/ayunliz
/apulita
/esperantujo 2
/keya
/teletubland
/atealia
/dollars-worldwide
/batootie
/new astropolis
/new austania
/whatthe
/defender z
/pasovo-nacobo
/the peoples union of sacco and vanzetti
/de dreamland
/orioni 2
/promethius prime
/yamsquik
/scotatrova
/auraian
/sambado
/the drezhian masters
/dogsrule11
/dioxin
/epicsaxe
/new foledonia
/idona
/apolonius
/the akasha colony
/eura
/the turkish state
/celle franca
/leytra incorporated
/trachae
/novokraina
/summer-rose
/irkalgurk
/keronika
/vulfar
/hourbor
/maltropia
/sandhora
/monfrox
/the sarudin
/the confederacy of the republic
/shemiki
/betterkorea
/jingoistic warhawk
/ffantasia
/valturus
/america in space
/lamebrainia
/main
/occoron
/shrek land
/beholdcorn
/republic of serbistan
/oceanion
/seriat
/landwhalius
/fleur de lys
/pracinha shock brigade 10
/the two point zero reich
/ryrgistan
/darth radix ii
/limington
/aurorae sinus
/the coalition of the magical unicorns
/tiltpa
/trump towerz
/united colonies of straya
/chris p
/mario galaxia
/v i o l e t
/epic ninjas
/quadrilaterals
/st paul country
/the empire of orion
/polska lithauen
/dwyllnia
/zonaleeland
/hiroei

[Imperium Anglorum]

I've got a beta version of the client ready for recruitment use. Please telegram me if you'd like to be a bug-tester (get a pre-release version, your name in the acknowledgements, and my gratitude! Sign up today!) before release of version 6, the first actual release of Communique!