Skip to content

CortanaChat - 1-on-1 IP-based instant messaging for XBMC4Xbox, complete with friends list!

Notifications You must be signed in to change notification settings

faithvoid/script.cortanachat

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

63 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Cortana Chat

1-on-1 IP-based messaging for XBMC4Xbox, complete with friends list!

menu1 messagemenu receivedmessages sentmessages friendmenu friends settingsmenu notification

Features:

  • Have 1-on-1 chats with your friends, directly on your Xbox!
  • Integrated Friends List capabilities lets you message/add/remove/block friends quickly, check their online statuses, and more!
  • Check your sent & received messages & compose a new message to users not on your friends list easily!
  • No backend servers means never (and always) out of date! As long as you've got an IPv4 address, you've got a chat client for your Xbox!
  • Don't know your external IP? Go into Settings and click "Show IP Address"!
  • UI is designed to be close to the Xbox 360's for ease of use!
  • Built using IRC philosophy & Xbox 360 design language.

Installation:

  • Grab current release file.
  • Unzip "CortanaChat" into the scripts folder your XBMC4Xbox installation, usually "Q:/scripts/". DO NOT RENAME THE FOLDER!
  • Run the script and it will ask for your username and save it to name.txt.

How to use:

  • Make sure port 3074 is forwarded on your router! This is the same as Xbox Live / Insignia's port, so if you're using these services you should have it forwarded already!
  • Run Cortana Chat and a menu will pop up, with the notification script automatically running in the background, even if you close the menu! This means you can still get messages even when watching movies or listening to music.
  • To send a message, you need to know your friend's IP address. You can send a message directly to their IP via the "Send Message" button, which prompts you for their IP and the message you'd like to send, or you can add them as a friend (which has you input their name and IP address) so you can instantly message them!
  • You can view your sent or received messages in the "Sent Messages" or "Received Messages" menus!
  • Don't know your external IP address? Click "Show IP Address", tell your friend your IP, and now you both can chat Xbox to Xbox!

FAQ:

  • "My friends list is a bit slow to load?"
  • This is to be expected, as when you open your friends list, a "PING" request is sent from your console to all of your friends' consoles to verify their online status. This can take a second or two, especially on slower connections / if you have more friends added.
  • "I was able to message my friend, but now I can't?"
  • Your friend's IP probably changed, you can edit their IP in the "Edit Friends" section on the Friends menu!
  • "How secure is this?"
  • Not very. It's all plaintext sent with no encryption from IP to IP, a-la IRC, so don't send anything you wouldn't want the entire world seeing. Also, be careful who you give your IP address to, as there are bad actors out there who could use it for nefarious purposes! Only add people you trust! I'd recommend using a VPN/proxy if you're concerned, but also you're already connecting to the internet on a 20+ year old console, so... (although I do want to see how feasible integrating SSL is after the primary code is complete).
  • "Is there an easier way to message my friend than getting their IP address?"
  • Unfortunately, not really, without getting an additional server that handles things such as usernames involved. Think of it like entering a phone number to call a friend!

To Do:

  • Fix message sorting (as some bug currently leads to older messages occasionally being shown first)
  • Add anti-spam functionality.
  • Set daily message limit to 150 (like Xbox 360).
  • Block users from messaging offline users (as the messaging functionality requires both users be online at the same time). Try to keep messages within 512 bytes (iirc Xbox 360 messages work this way, with a 500 character limit with the first 12 characters being reserved for the Gamertag).
  • Integrate some sort of user authentication? SSL? Maybe pull the username from the XBMC profile instead of name.txt instead?
  • Group chat support? (likely possible with one host as a message relay)
  • Voice Messages(?) (Seems possible as XBMC4Xbox supports the Communicator, at least for karaoke. Building to to these 360 standards: 15-second clips @ 64kbps with a 20-message storage limit. Will have to try after getting a Hawk or puck.)
  • VoIP / voice chat? (Also maybe possible? Most likely won't be able to use any sort of voice processing effects so no voice masking or anything, but direct audio-to-audio should, in theory, work. Plan is to target 64kbps.)
  • Basic file transfer? (possible, but needs to be there for a reason).

Bugs:

  • Currently, messages with commas (,) don't show up properly in the notifications. but they'll show up just fine in the "Received Messages" section! So if you receive a (half) blank message, that's probably why. Try not to use them!

About

CortanaChat - 1-on-1 IP-based instant messaging for XBMC4Xbox, complete with friends list!

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages