Add-on:IrcChat: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
>MassIV
m (Addon-Bot repo category update)
Tag: Manual revert
 
(106 intermediate revisions by 11 users not shown)
Line 1: Line 1:
{{Addon  
{{Addon  
|Name=IrcChat
|Name=IrcChat
|provider-name=
|provider-name=divingmule, MassIV
|ID=script.ircchat
|ID=script.ircchat
|latest-version=0.0.1
|latest-version=1.0.1
|extension point=xbmc.python.script
|extension point=xbmc.python.script
|provides=
|provides=executable
|Summary=Irc chat client  for xbmc. For a.o. chat on video streaming sites.
|Summary=An IRC Client
|Description='''Under Construction!''' Irc chat client for xbmc. For a.o. chat on video streaming sites.
|Description=
      This add-on is a basic IRC client for Kodi mediacenter.
      Internet Relay Chat (IRC) is a protocol for live interactive
      Internet text messaging (chat) or synchronous conferencing.
      It is mainly designed for group communication in discussion forums, called channels.
   
|Platform=all
|Platform=all
|Language=
|Language=
|License=
|License=GNU GENERAL PUBLIC LICENSE. Version 2, June 1991
|Forum=
|Forum=http://forum.kodi.tv/showthread.php?tid=163588
|Website=
|Website=http://kodi.wiki/view/Add-on:IrcChat
|Source=
|Source=https://github.com/divingmule/script.ircchat
|Email=
|Email=
|broken=
|broken=
|icon url=http://wiki.xbmc.org/images/d/dc/IrcChat.png}}
|icon url=http://mirrors.kodi.tv/addons/leia/script.ircchat/icon.png}}


== IRC ==
== IRC ==
Line 23: Line 28:
[http://en.wikipedia.org/wiki/Internet_Relay_Chat Internet Relay Chat Wiki]
[http://en.wikipedia.org/wiki/Internet_Relay_Chat Internet Relay Chat Wiki]


Many chat's on the internet use an IRC server behind the scenes. It's well established and usable on all operating systems.
Many web chat's on the internet use an IRC server behind the scenes. It's well established and usable on all operating systems.
XBMC has it's own IRC channel on Freenode. Much like the forum, you can ask a question there.  
And for instance XBMC, has it's own IRC channel on Freenode. Much like the forum, a place to talk or ask a question.  
Now lets have a look at that channel. The host looks like this '''irc.freenode.org'''. Kind of like a web address.
Now lets have a look at that channel as example. The host looks like this '''irc.freenode.org'''. Kind of like a web address.
And you could in fact connect to the channel with a browser like so:
And you could in fact connect to the channel with a browser like so:


[http://irc.lc/freenode/xbmc/irctc@@@ XBMC via webchat]
[http://irc.lc/freenode/xbmc/irctc@@@ XBMC via webchat]


That's nice. But why a chat in a media center?
That's nice. But why a chat in a media center? Well, many live video streaming websites have a chat next to the stream. And watching these streams on our mediacenter without them sometimes felt like listening to half a conversation. So that is how the first version of the chat came to be. It was just read only, but then it started to grow.
Well, many live video streaming websites have a chat on their websites. And watching these streams without them sometimes felt like listening to half a conversation. So that is how the first version of chat came to be. And it was just read only.


== Popular servers ==
== Popular servers ==
Line 43: Line 47:
After installing the addon.  
After installing the addon.  
* Go into the addon settings.  
* Go into the addon settings.  
{{highlight|bordered=yes|[[Settings|Program Add-Ons -> IrcChat -> Context -> Add-On Settings]]}}
{{highlight|bordered=yes|[[Add-ons|Program Add-Ons -> IrcChat -> Context -> Add-On Settings]]}}
* Here you can your initial login information, host and channel.
* Here you can input your initial login information, host and channel.
* Start a steam or playlist.
* Next, start a steam or playlist.
* Go to programs and start the IrcChat addon.
* Go to programs and start the IrcChat addon (use TAB toswitch to fullscreen video).


* It is also possible to map a key to starting the script. As an easy way to start, switch hosts or usernames.
* It is also possible to map a key to starting the script. As an easy way to start during playback, switch hosts or usernames.
<source lang="xml">
<syntaxhighlight lang="xml">
<F1>RunScript(script.ircchat, run_irc=True,nickname=MyNick,username=name,password=pass123,host=irc.freenode.org,channel=xbmc</F1>
<F1>RunScript(script.ircchat, run_irc=True&nickname=MyNick&username=name&password=pass123&host=irc.freenode.org&channel=xbmc)</F1>
</source>
</syntaxhighlight>


* There is a button in the top to slide out either a list of channels or a list of users. Depending on whether you are in a channel or not.  
* There is a button in the top {{highlight|bordered=yes|[[List Container|<]]}} to slide out either a list of channels or a list of users. Depending on whether you are in a channel or not.
* A button to change colors {{highlight|bordered=yes|[[Spin Control|c]]}} that gives you a 'spin control'.
* The chat's keyboard input also allows you to input a channel name to connect to IF you are not in a channel. You do not need to enter the # in front of the channel name.  
* The chat's keyboard input also allows you to input a channel name to connect to IF you are not in a channel. You do not need to enter the # in front of the channel name.  
* Selecting your own name in the list of users allows you options like changing your name IF this is supported by the host you are on.
* Selecting your own name in the list of users allows you options like changing your name IF this is supported by the host you are on.


==Screenshots==
== Login Token ==
As of Sept. 17, 2013, Twitch now requires that you log into IRC using an OAuth token instead of your plaintext password or hash for additional security. To generate a token, visit: http://www.twitchapps.com/tmi/


== Screenshots ==
<gallery widths=200px heights=113px>
<gallery widths=200px heights=113px>
File:script.ircchat-screenshot-1.png  
File:script.ircchat-screenshot-1.png  
Line 66: Line 73:
</gallery>
</gallery>


== Add-on integration ==
If you wish to integrate the chat with your video streaming add-on. Host, nickname, and username are required, the other parameters are optional.
<syntaxhighlight lang="xml">
<settings>
  <category label="Chat">
    <setting id="run_chat" type="bool" label="Run IrcChat" default="false" />
    <setting id="nickname" type="text" label="Justin.tv Username" default="" visible="eq(-1,true)" />
    <setting id="password" type="text" label="Justin.tv Password" default="" option="hidden" visible="eq(-2,true)" />
  </category>
</settings>
</syntaxhighlight>


[[Category:Frodo add-on repository]]
Then pass the host, channel and user parameters of your website to the chat.
[[Category:Eden add-on repository]]
<syntaxhighlight lang="python">
#if stream started:
    xbmc.sleep(3000)
    if addon.getSetting('run_chat') == 'true':
        xbmc.executebuiltin(
            "RunScript(script.ircchat, run_irc=True&nickname=%s&username=%s&password=%s&host=%s&channel=%s)"
            %(addon.getSetting('nickname'), addon.getSetting('nickname'),
              addon.getSetting('password'), name+'.jtvirc.com', name)
            )
</syntaxhighlight>
 
== Skin integration ==
To simply overwrite one or two images (for example the loading .png). Add a folder to your skin media folder called "IrcChat".
And place your own loading image in there with the same name as it has in the IrcChat add-on. In this case "ChatBusy.png".
 
To completely adjust all aspects of the chat layout. Place an xml file with the name "script-IrcChat-main.xml" in your skin's 720p folder. Or start by taking a copy of the one from the add-on. Note: Doing so requires all images to be in your skin, it will no longer look in the add-on folder.
 
[[Category:Add-ons with license tag]]
[[Category:Add-ons with source tag]]
[[Category:Add-ons with website tag]]
[[Category:All add-ons]]
[[Category:Program add-ons]]
[[Category:Gotham add-on repository]]
[[Category:Helix add-on repository]]
[[Category:Isengard add-on repository]]
[[Category:Jarvis add-on repository]]
[[Category:Krypton add-on repository]]
[[Category:Leia add-on repository]]

Latest revision as of 04:14, 17 October 2021

IrcChat
icon.png

See this add-on on the kodi.tv showcase

Author: divingmule, MassIV
Website: link
Type: Program
Repo:

License: GPL v2.0
Source: Source code
Summary: An IRC Client
Home icon grey.png   ▶ Add-ons ▶ IrcChat
Attention talk.png Need help with this add-on? See here.

This add-on is a basic IRC client for Kodi mediacenter.
      Internet Relay Chat (IRC) is a protocol for live interactive
      Internet text messaging (chat) or synchronous conferencing.
      It is mainly designed for group communication in discussion forums, called channels.

Installing

This add-on is installed from the Add-on browser located in Kodi as follows:

  1. Settings
  2. Add-ons
  3. Install from repository
  4. Program Add-ons
  5. IrcChat
  6. Install

IRC

Internet Relay Chat (IRC) is a protocol for live interactive Internet text messaging (chat) or synchronous conferencing.

Internet Relay Chat Wiki

Many web chat's on the internet use an IRC server behind the scenes. It's well established and usable on all operating systems. And for instance XBMC, has it's own IRC channel on Freenode. Much like the forum, a place to talk or ask a question. Now lets have a look at that channel as example. The host looks like this irc.freenode.org. Kind of like a web address. And you could in fact connect to the channel with a browser like so:

XBMC via webchat

That's nice. But why a chat in a media center? Well, many live video streaming websites have a chat next to the stream. And watching these streams on our mediacenter without them sometimes felt like listening to half a conversation. So that is how the first version of the chat came to be. It was just read only, but then it started to grow.

Popular servers

  • Xbmc.org: irc.freenode.org #xbmc
  • Justin.tv: channel_name.jtvirc.com #channel_name
  • Twit.tv: irc.twit.tv #twitlive
  • Twitch.tv: channel_name.jtvirc.com #channel_name
  • Ustream.tv: chat1.ustream.tv OR c.ustream.tv #channel_name

How To

After installing the addon.

  • Go into the addon settings.

Program Add-Ons -> IrcChat -> Context -> Add-On Settings

  • Here you can input your initial login information, host and channel.
  • Next, start a steam or playlist.
  • Go to programs and start the IrcChat addon (use TAB toswitch to fullscreen video).
  • It is also possible to map a key to starting the script. As an easy way to start during playback, switch hosts or usernames.
<F1>RunScript(script.ircchat, run_irc=True&nickname=MyNick&username=name&password=pass123&host=irc.freenode.org&channel=xbmc)</F1>
  • There is a button in the top < to slide out either a list of channels or a list of users. Depending on whether you are in a channel or not.
  • A button to change colors c that gives you a 'spin control'.
  • The chat's keyboard input also allows you to input a channel name to connect to IF you are not in a channel. You do not need to enter the # in front of the channel name.
  • Selecting your own name in the list of users allows you options like changing your name IF this is supported by the host you are on.

Login Token

As of Sept. 17, 2013, Twitch now requires that you log into IRC using an OAuth token instead of your plaintext password or hash for additional security. To generate a token, visit: http://www.twitchapps.com/tmi/

Screenshots

Add-on integration

If you wish to integrate the chat with your video streaming add-on. Host, nickname, and username are required, the other parameters are optional.

<settings>
  <category label="Chat">
    <setting id="run_chat" type="bool" label="Run IrcChat" default="false" />
    <setting id="nickname" type="text" label="Justin.tv Username" default="" visible="eq(-1,true)" />
    <setting id="password" type="text" label="Justin.tv Password" default="" option="hidden" visible="eq(-2,true)" />
  </category>
</settings>

Then pass the host, channel and user parameters of your website to the chat.

#if stream started:
    xbmc.sleep(3000)
    if addon.getSetting('run_chat') == 'true':
        xbmc.executebuiltin(
            "RunScript(script.ircchat, run_irc=True&nickname=%s&username=%s&password=%s&host=%s&channel=%s)"
            %(addon.getSetting('nickname'), addon.getSetting('nickname'),
              addon.getSetting('password'), name+'.jtvirc.com', name)
            )

Skin integration

To simply overwrite one or two images (for example the loading .png). Add a folder to your skin media folder called "IrcChat". And place your own loading image in there with the same name as it has in the IrcChat add-on. In this case "ChatBusy.png".

To completely adjust all aspects of the chat layout. Place an xml file with the name "script-IrcChat-main.xml" in your skin's 720p folder. Or start by taking a copy of the one from the add-on. Note: Doing so requires all images to be in your skin, it will no longer look in the add-on folder.