Home

Welcome to your wiki!

This is the default page, edit it as you see fit. To add a new page simply reference it within brackets, e.g.: [SamplePage].

The wiki uses Markdown syntax.

Project Members:

• sanzstez (admin)

[sanzstez]

Коротко о программе

• Программа обладает минимально необходимым функционалом для удобного непрерывного мониторинга состояний цен на бирже криптовалют btc-e.com . Hard минимал и ничего больше. Не нужно вводить никакие ключи и проходить авторизацию. Используется исключительно публичное API биржи!
• Разработка ведется на языке Python 2.7.x, для создания графической оболочки используется PyQt (PyQt4-4.10.3-gpl-Py2.7-Qt4.8.5-x64).
• В данный момент существует сборка программы в исполняемый файл только для ОС семейства Windows (XP, Vista, 7, 8), с помощью модуля Py2exe. Для ОС семейства Linux и Mac OS X возможен запуск программы напрямую из исходников. Сам продукт является кроссплатформенным решением и может быть запущен на этих системах при условии наличия установленных интерпретаторов Python и модуля PyQt.

Установка и запуск на платформе Windows

Необходимо распаковать архив с программой в папку и запустить исполняемый файл btce_go.exe (Можно создать потом ярлык на рабочем столе).

Установка и запуск из исходников на платформе Ubuntu 12.04

Распаковать папку с программой в домашнюю директорию, предварительно выполнив установку компонентов.

$ sudo apt-get install python-pyaudio python-qt4
$ python btce_go.pyw

Основные возможности программы

Каждый из курсов валют имеет свой собственный информационный блок на котором указаны:
* Пиктограммы пар валют (с коротким описанием каждой валюты в всплывающем окошке).
* Последняя цена ордера на продажу.
* Разница с предыдущей ценой на продажу.
* Последняя цена ордера на покупку.
* Разница с предыдущей ценой на покупку.
* Время обновления курса по бирже.
* Цены: последняя, минимальная, максимальная, средняя и разница (разница между макс и мин ценами).
* Иконка будильника: реализует механизмы звуковых уведомлений и уведомлений в трее.

Система уведомлений

В программе доступны звуковые уведомления, которые устанавливаются на цену продажи криптовалюты Для установки цен необходимо нажать на иконку будильника и установить необходимую цену при какой сработает одиночный звуковой сигнал.
* Цена минимума не может быть больше цены максимума.
* Возможно задать точность цены с 7 знаками после запятой.
* Чекбокс "Активен" позволяет включить/выключить сигнал по цене.
* При наведении на иконку будильника, если цена установлена и отмечен чекбокс "Активен", отображаются текущие минимум и максимум цены или один из них.

Уведомления в трее. В случае превышения порогов цен, помимо звуковых уведомлений, отображается всплывающее сообщение в трее. Если превышений несколько - они группируются. В трее отображается текущая цена по курсу.

Уведомление в заголовке окна программы В заголовке программы отображается текущий курс на продажу первой из списка криптовалют, заданых в настройках.

Нижняя панель программы содержит время последнего обновления данных программой и командные кнопки.

Командные кнопки:
* Включить/выключить уведомления в трее - позволяет переключать показ всплывающих сообщений о превышениях в системном трее.
* Поверх всех окон - позволяет закрепить программу поверх все остальных окон.
* Сделать скриншот курсов - позволяет сделать скриншот текущего курса валют выбранных в программе.
Доступна горячая комбинация клавиш Ctrl+Q.
* Переключить консоль - активация и дезактивация консоли ошибок обращения к серверу API.
Консоль является служебным инструментом и может быть отключена во время обычной работы.

Основные настройки программы:

• Используя API биржи, программа загружает и обрабатывает актуальные курсы валют.
• Возможность выбора мониторинга только необходимого перечня криптовалют из списка доступных. Чтобы задать перечень и нужный порядок валют для мониторинга необходимо в конфигурационном файле settings.ini найти значение crypto_currencies_list и изменить его значение.

Например, для отображения курсов BTC/USD, LTC/USD и LTC/BTC, необходимо указать:

crypto_currencies_list = btc_usd, ltc_usd, ltc_btc

Важно! Код обозначения валют указывается только через запятые.

Коды обозначений для каждой пар валют, доступных на данный момент на бирже:

Пара валют	Расшифровка	Код
BTC/USD	Bitcoin/Доллар	btc_usd
BTC/RUR	Bitcoin/Рубль	btc_rur
BTC/EUR	Bitcoin/Euro	btc_eur
LTC/BTC	Litecoin/Bitcoin	ltc_btc
LTC/USD	Litecoin/Доллар	ltc_usd
LTC/RUR	Litecoin/Рубль	ltc_rur
LTC/EUR	Litecoin/Euro	ltc_eur
NMC/BTC	Namecoin/Bitcoin	nmc_btc
NMC/USD	Namecoin/Доллар	nmc_usd
NVC/BTC	Novacoin/Bitcoin	nvc_btc
NVC/USD	Novacoin/Доллар	nvc_usd
USD/RUR	Доллар/Рубль	usd_rur
EUR/USD	Euro/Доллар	eur_usd
EUR/RUR	Euro/Рубль	eur_rur
TRC/BTC	Terracoin/Bitcoin	trc_btc
PPC/BTC	Peercoin/Bitcoin	ppc_btc
PPC/USD	Peercoin/Доллар	ppc_usd
FTC/BTC	Feathercoin/Bitcoin	ftc_btc
XPM/BTC	Primecoin/Bitcoin	xpm_btc
BTC/CNH	Bitcoin/Юань	btc_cnh
BTC/GBP	Bitcoin/Фунт	btc_gbp
LTC/CNH	Litecoin/Юань	ltc_cnh
LTC/GBP	Litecoin/Фунт	ltc_gbp
USD/CNH	Доллар/Юань	usd_cnh
GBP/USD	Фунт/Доллар	gbp_usd

• Задать период обновления курса можно с помощью параметра update_period (указывается в секундах):

update_period = 5

• Параметр fixed_update_period принимает значения False и True (Выкл. и Вкл.). Позволяет жестко задать период обновления курса валют, строго соответствующий параметру update_period. По умолчанию стоит плавающий период, который позволяет более динамично обновлять курс.

fixed_update_period = False

• Таймаут запроса от API сервера биржи задается параметром request_timeout (указывается в секундах):

request_timeout = 5

• Возможность указать количество знаков после запятой для разницы курсов - параметр exp_signs:

exp_signs = 6

• Служебные параметры show_logger , fixed_window , show_tooltip хранят состояния активности/неактивности компонентов, которые можно переключать из программы.

Планы на будущее

В случае, если программа обретет какой-никакой успех среди пользователей биржи я буду рассматривать возможность усовершенствования программы.

Из возможных, есть такие идеи:
* [Выполнено] Добавить возможность установки звукового сигнала и пороговых значений для каждого из курсов криптовалют чтобы не прозевать свои денежки =) (Минимум, максимум для продажи).
* Добавить возможность работы через прокси.
* Локализация программы на разные языки.
* Моментальная загрузка скриншота текущего курса валют на фотообменный хостинг.
* Создать графическое окно настройки программы.

Принять участие в разработке программы

• Я работаю по такой схеме, что каждый желающий может принять участие в разработке программы, ее доводки и совершенствования.
• Рассматриваю пул-реквесты с новыми фичами в основную ветку программы.
• У программы есть своя группа Вконтакте, где можно внести свои предложения -> http://vk.com/btce_go (Стена и обсуждения открыты).

Ваша финансовая поддержка существенно ускорит разработку программы и внедрение новых возможностей:

BTC: 151xG1K5pUVGbvguYd2vPfBSTy66Uifoq4
LTC: LVdozFjRfpWJb7j5kDRrkmvMjBaFsm1Wza

Спасибо. Я рад, если кому-нибудь моя программа была, есть и будет полезной.

Changelog

• 1.3.1 Добавлены пары валют для CNH, GBP. Обновлен вид счетчика последнего запроса курсов
• 1.3.0 Звуковые уведомления. Всплывающие сообщения.
• 1.2.9 С версии 1.2.9 добавлен новый параметр в settings.ini fixed_update_period, который позволяет корректировать параметры запросов к серверу API. Подробнее в документации. Не забудьте обновить файл конфигурации. Также переработана логика работы с потоками.
• 1.2.8 Доработана работа с потоками.