Check out the Widgetoko announcement blog post.
Widgetoko enables users to connect to Twitter and watch tweets arrive in real-time that match a specified search term.
There are several options for installing Widgetoko. Packaged installers are available as .exe (Win) and .dmg (Mac), or you can build the project from the original source code.
Build from source
- Install Yarn
- Clone the Widgetoko repo or download source
- Using the Command (Win) or Terminal (Mac), browse to the
- Run the following
If this is your first time running
yarn install on the
/dist/ folder, Yarn may take a few minutes to download the required packages. Just let the process run.
yarn install is complete, run the following
yarn start command and an instance of the Widgetoko app should start automatically.
Compile C# source
- Double click the
/src/Widgetoko.slnfile to open in Visual Studio
Rebuild Solutionfrom the main Visual Studio menu
- Run the command
yarn install(if you have not done so earlier)
You can then start an instance of the Widgetoko app by running the command
It is also possible to start Widgetoko directly from Visual Studio by clicking the Start button or hitting F5 or Ctrl + F5, BUT FIRST... there are two Project Properties that need to be set (see image below).
- Right-click on the Widgetoko Project in the Solution, and select Properties
- Under the Debug tab, select Start external program and paste the value
- In the Command line arguments field, paste the value
Now the Start button will work as expected and the Widgetoko app will launch.
Configure Twitter Tokens
A connection to the Twitter Stream is required, so we must register the Widgetoko app with Twitter and generate Access Tokens. This is a required step to tap into the Tweet stream.
Browse to https://apps.twitter.com/app/new
Fill in the fields (App name, Description, WebSite). You should use your own unique Application name, and any values you want for the other fields.
Press Create your Twitter application button.
The application has been created. Now go to Keys and Access Tokens tab.
Press Create My access token button to generate keys.
That's it, all tokens are generated:
- The last step. You should copy-paste those tokens into Widgetoko app. Run Widgetoko, press F2 (or File > Options) to open Options form, paste your tokens as shown below. Click Save.
Your tokens will be saved in %appdata%/widgetoko/UserSettings.json in an obfuscated format. You have several options to remove tokens afterwards:
- Just delete that file.
- Replace the Options form with empty values, then click Save to overwrite your old token values.
- Invalidate the tokens from the Twitter app configuration, or just delete the app from Twitter.
Creating an actual installer for the Widgetoko app is very simple. To create the installer, use the following steps:
- Clone this repo (if you have not done so already)
- With a Command Window (Windows) or Terminal (Mac), browse to the
- Run the following
yarn install yarn build
Installers can be created for Mac, Windows, and Linux. The installer creation process should take no more than a few minutes, but needs to be run on each platform you support. If you want an .exe for Windows, run the command on a Windows machine. Need a Mac installer? run the command on a Mac.
The installer files, such as .exe (Win) and .dmg (Mac), will be added to the /dist/installers/ folder and those files can be deployed to your users.