This repository has been archived on 2023-09-20. You can view files and clone it, but cannot push or open issues or pull requests.
chromesoul/README.md

83 lines
3.9 KiB
Markdown
Raw Normal View History

2012-10-17 23:04:31 +02:00
## What is chromesoul?
2012-10-17 22:31:04 +02:00
2012-10-17 23:31:58 +02:00
Chromesoul is a minimalist NetSoul client for Google Chrome. It aim to connect to the NetSoul server and stay active, but does not provide all the functionalities you can expect from a real client.
2012-10-17 23:04:31 +02:00
## Why?
2012-10-21 23:18:55 +02:00
When you're on the PIE, you're stuck in it unless you are connected to netsoul, and with multiple boot and mobile devices it's a real pain to configure many NetSoul clients. That's why chromesoul is awesome: not only it's a cross-platform NS client, but with the Chrome synchronisation it's automaticaly installed and configured.
2012-10-17 23:04:31 +02:00
2012-10-21 12:42:48 +02:00
## Requirements
Sockets have been introduced in Chromium 24. Therefore, it is required to have a web-browser based on Chromium 24 or newer. At the time of writing, it's available on the [beta channel](http://www.chromium.org/getting-involved/dev-channel). For more informations, please refer to the [Chromium development calendar and release info](http://dev.chromium.org/developers/calendar).
2012-10-21 12:42:48 +02:00
2012-10-17 23:04:31 +02:00
## Features
### Password encryption
2012-11-07 10:53:48 +01:00
Storing your socks password encrypted is a priority but is not available yet. Yes, the chromesoul dev version is unsafe; so is the official NetSoul server which doesn't store a hash but the password itself (it's required by the NetSoul protocol).
2012-10-17 23:04:31 +02:00
### Messages
Because the only purpose of this extension is to provide an access to internet when you're on the PIE, there is no plan to support messages at this time. Thoses stupid guys who have fun spamming everyone by broadcasting messages are the second reasons why you won't see any message using chromesoul. Maybe one day I'll write a chat interface. Since version 0.2, chromesoul have a dedicated window and is more likely to integrate a chat interface.
### Contacts
If you cannot send and receive messages, you don't need a contact list.
2012-10-17 23:31:58 +02:00
2012-10-21 23:18:55 +02:00
### State change
Same as contacts. Why changing your state if you're not gonna talk?
2012-10-17 23:31:58 +02:00
2012-10-21 23:54:31 +02:00
## FAQ
### How do I install this extension?
Because it's not packaged yet, you have to:
* Download it
* Use the developer mode
* Click on "Load unpackaged extension..." and select the chromesoul directory
### Will you package it?
Yes, as soon as sockets are supported in the stable channel.
2012-11-07 10:53:48 +01:00
### How do I start chromesoul?
Just like any other app:
* open a new tab (Ctrl + T)
* click on the "apps" tab (have a look at the bottom of the page)
* click on "chromesoul"
2012-10-31 11:45:58 +01:00
2012-10-21 23:54:31 +02:00
### Could not load extension from '/path/to/chromesoul'. Invalid value for 'permissions[2]'.
It seems your browser doesn't support sockets. Have you checked the requirements?
### Do I really have to compile the version from dev channel?
No, you can wait until it comes to stable.
2012-10-23 11:25:06 +02:00
### Chromesoul isn't an extension but a packaged app!
Yes, you're right. Chromesoul should be an extension, but sockets can be used in apps only.
2012-10-21 23:54:31 +02:00
### Where do I send and receive messages?
Please have a look at the features lists.
### Will you ever support sending and receiving messages?
Maybe. If someone pays me, I will; otherwise I'll do it if have time to invest in this project. Notice: I accept beer as payment.
### I don't want chromesoul to support sending and receiving messages, will you do something about it?
Yes, if it comes, you'll be able to shut it down very easily. So, keep calm and carry on.
2012-10-21 23:54:31 +02:00
### I talked to you on netsoul but you never reply!
I started this project for my personal usage, which means I use it. Now look at the features list and the previous questions.
2012-11-07 10:53:48 +01:00
### I found a bug, what should I do?
2012-10-21 23:54:31 +02:00
Hum, please [report it](https://github.com/TychoBrahe/chromesoul/issues) with as much details as you can. Thanks in advance.
### I hate chromesoul!
It's your opinion and I don't care about it.
### I love chromesoul!
I'm happy you like it :-)
2012-10-17 23:31:58 +02:00
## Licence
Chromesoul is released under an [ISC licence](http://en.wikipedia.org/wiki/ISC_license "ISC licence"). See the LICENCE.txt file for more details.
2012-10-21 12:59:38 +02:00
Chromesoul uses third-party free softwares which belongs to their respective owners. Such softwares are listed in the CREDITS.md file.