Whalesong¶
Whalesong is an asyncio python library to manage WebApps remotely. Currently WhatsappWeb is implemented
Warning
NEW VERSION 0.7.0
With new version some new requirements have been defined and some API change have been committed.
Version 0.7.0 introduces new driver for Chromium browser. It has required some changes on base driver’s API. It should not affect anyone. But be aware.
Warning
NEW VERSION 0.7.
Stream model now uses enumerations. It means that if you check stream states
you must be aware that they are not a string anymore, now they are enumerations. Look at
documentation.
Binary Requirements¶
- Python 3.6+
Using Firefox¶
- Geckodriver
- Firefox 50+
Using Chromium¶
Execute this after installation:
$ pyppeteer-install
Development requirements¶
- node (only for development)
- npm (only for development)
- make (only for development)
Installation¶
Starting with version 0.7.0 Whalesong introduces new browsers backends. It means you must decide which browser backend you want to use. So, depending on it:
Tip
You could install both with no problems.
Using Firefox¶
$ pip3 install whalesong[firefox]
Using Chronium¶
$ pip3 install whalesong[chromium]
If you choose Chromium backend, you should execute this after installation:
$ pyppeteer-install
It will download a patched Chromium distribution needed for that backend.
Table of contents¶
- Features
- Browser backends
- Examples
- API reference
- Whalesong Service
- Whalesong Driver
- Result types
- Base Models
- Base Managers
- Contact references
- Chat references
- Message references
- Managers
- Models
- VCardItem
- BaseMessage
- QuotedMessageMixin
- MentionsMixin
- LinkContentMixin
- MediaMixin
- MediaFrameMixin
- AuthorMixin
- MediaStreamMixin
- TextMessage
- ImageMessage
- VideoMessage
- AudioMessage
- PTTMessage
- DocumentMessage
- VCardMessage
- MultiVCardMessage
- LocationMessage
- PaymentMessage
- GroupNotificationMessage
- StickerMessage
- MessageAck
- MessageInfo
- Group metadata references
- Wap references
- Sticker pack references
- Connection references
- Stream references
- Presence references
- Profile pictures references
- Status references
- Live location references
- Mute references
- Display information references
- Status V3 references
- Storage references
- Whalesong Errors
- Firefox Profile
- How to develop
- Changelog
Indices and tables¶
Legal¶
This code is in no way affiliated with, authorized, maintained, sponsored or endorsed by WhatsApp or any of its affiliates or subsidiaries. This is an independent and unofficial software. Use at your own risk.
