feat: add android browser (can receive viewonce) #2201

vinikjkkj · 2025-12-19T04:56:37Z

how to use

	const sock = makeWASocket({
		version,
		logger,
		auth: {
			creds: state.creds,
			/** caching makes the store faster to send/recv messages */
			keys: makeCacheableSignalKeyStore(state.keys, logger),
		},
		browser: Browsers.android('13'), // here
		msgRetryCounterCache,
		generateHighQualityLinkPreview: true,
		// ignore all broadcast messages -- to receive the same
		// comment the line below out
		// shouldIgnoreJid: jid => isJidBroadcast(jid),
		// implement to handle retries & poll updates
		getMessage
	})

whiskeysockets-bot · 2025-12-19T04:56:47Z

Thanks for opening this pull request and contributing to the project!

The next step is for the maintainers to review your changes. If everything looks good, it will be approved and merged into the main branch.

In the meantime, anyone in the community is encouraged to test this pull request and provide feedback.

✅ How to confirm it works

If you’ve tested this PR, please comment below with:

Tested and working ✅

This helps us speed up the review and merge process.

📦 To test this PR locally:

# NPM
npm install @whiskeysockets/baileys@WhiskeySockets/Baileys#android-browser

# Yarn (v2+)
yarn add @whiskeysockets/baileys@WhiskeySockets/Baileys#android-browser

# PNPM
pnpm add @whiskeysockets/baileys@WhiskeySockets/Baileys#android-browser

If you encounter any issues or have feedback, feel free to comment as well.

WolfyFlutter · 2025-12-19T09:15:31Z

sir i got this error
file:///C:/Users/Wolfy/github/angelina/index.js:145
browser: Browsers.android('13'), // here,
^

TypeError: Browsers.android is not a function
at startSock (file:///C:/Users/Wolfy/github/angelina/index.js:145:23)

Node.js v24.11.1
Assertion failed: !(handle->flags & UV_HANDLE_CLOSING), file src\win\async.c, line 76

my package json

{
  "dependencies": {
    "@cacheable/node-cache": "^1.7.4",
    "@whiskeysockets/baileys": "github:WhiskeySockets/Baileys#android-browser",
    "baileys": "github:WhiskeySockets/Baileys",
    "pino": "^9.14.0"
  },
  "name": "bot_wa",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "node --inspect --expose-gc index.js",
    "start": "node index.js"
  },
  "keywords": [
    "baileys",
    "whatsapp",
    "bot"
  ],
  "author": "wolep",
  "license": "MIT",
  "type": "module"
}

my config

  sock = makeWASocket({
    version,
    auth: {
      creds: state.creds,
      /** caching makes the store faster to send/recv messages */
      keys: makeCacheableSignalKeyStore(state.keys, logger),
    },
    browser: Browsers.android('13'), // here,
    msgRetryCounterCache,
    cachedGroupMetadata: store.getGroupMetadata,
    logger,
    patchMessageBeforeSending,
    syncFullHistory: false,
    shouldSyncHistoryMessage: msg => {
      console.log("should sycn history message", msg)
      return false
    },
  });

i did delete node_modules and package-lock.json, and then hit npm i

SheIITear · 2025-12-19T09:21:08Z

sir i got this error

file:///C:/Users/Wolfy/github/angelina/index.js:145

browser: Browsers.android('13'), // here,

                  ^

TypeError: Browsers.android is not a function

at startSock (file:///C:/Users/Wolfy/github/angelina/index.js:145:23)

Node.js v24.11.1

Assertion failed: !(handle->flags & UV_HANDLE_CLOSING), file src\win\async.c, line 76

my package json

{

  "dependencies": {

    "@cacheable/node-cache": "^1.7.4",

    "@whiskeysockets/baileys": "github:WhiskeySockets/Baileys#android-browser",

    "baileys": "github:WhiskeySockets/Baileys",

    "pino": "^9.14.0"

  },

  "name": "bot_wa",

  "version": "1.0.0",

  "description": "",

  "main": "index.js",

  "scripts": {

    "test": "node --inspect --expose-gc index.js",

    "start": "node index.js"

  },

  "keywords": [

    "baileys",

    "whatsapp",

    "bot"

  ],

  "author": "wolep",

  "license": "MIT",

  "type": "module"

}

my config

  sock = makeWASocket({

    version,

    auth: {

      creds: state.creds,

      /** caching makes the store faster to send/recv messages */

      keys: makeCacheableSignalKeyStore(state.keys, logger),

    },

    browser: Browsers.android('13'), // here,

    msgRetryCounterCache,

    cachedGroupMetadata: store.getGroupMetadata,

    logger,

    patchMessageBeforeSending,

    syncFullHistory: false,

    shouldSyncHistoryMessage: msg => {

      console.log("should sycn history message", msg)

      return false

    },

  });

i did delete node_modules and package-lock.json, and then hit npm i

You didn't even use the pr? The code is not pushed into main.

WolfyFlutter · 2025-12-19T09:28:09Z

You didn't even use the pr? The code is not pushed into main.

damn... i wasnt notice my package.json 😭😭.. brb testing. sorry i was sleepy lol xD

WolfyFlutter · 2025-12-19T09:43:01Z

very good, it work! excellent job! no need to reply to see rvo content.. no more stubtype message absent from node

purpshell · 2025-12-19T11:23:02Z

src/Utils/validate-connection.ts

 const getPlatformType = (platform: string): proto.DeviceProps.PlatformType => {
 	const platformType = platform.toUpperCase()
+	if (platformType === 'ANDROID') {
+		return proto.DeviceProps.PlatformType.ANDROID_PHONE


interesting. Is this the only thing for companion devices? Can you try ipad

You can also try enum IPHONE

DavidModzz · 2025-12-19T14:13:23Z

Tested and working

astrox11 · 2025-12-19T15:25:38Z

Crazy workaround fix 🙌 amazing job

purpshell · 2025-12-19T19:46:04Z

Good fix but we need to insure full support for companion devices

@jlucaso1 could you use frida perhaps to pin the android companion mode to bartender?
note: you can use the android studio emulators, they come pre-rooted, you just need to upload the frida-server there

cleitonme · 2025-12-20T16:53:59Z

Here I can't connect WhatsApp Business, it only connects normally. It works but had this problem

vinikjkkj · 2025-12-20T22:59:27Z

Good fix but we need to insure full support for companion devices

@jlucaso1 could you use frida perhaps to pin the android companion mode to bartender? note: you can use the android studio emulators, they come pre-rooted, you just need to upload the frida-server there

i found this when i was reversing companion mode, if you guys want i have ~90% reversed (CRSC v2/v3)

vinikjkkj · 2025-12-21T16:14:18Z

Here I can't connect WhatsApp Business, it only connects normally. It works but had this problem

try changing from

		platform: config.browser[1].toLocaleLowerCase().includes('android')
			? proto.ClientPayload.UserAgent.Platform.ANDROID
			: proto.ClientPayload.UserAgent.Platform.WEB,

to

		platform: config.browser[1].toLocaleLowerCase().includes('android')
			? proto.ClientPayload.UserAgent.Platform.SMB_ANDROID
			: proto.ClientPayload.UserAgent.Platform.WEB,

purpshell · 2025-12-22T07:30:48Z

Here I can't connect WhatsApp Business, it only connects normally. It works but had this problem

try changing from

		platform: config.browser[1].toLocaleLowerCase().includes('android')
			? proto.ClientPayload.UserAgent.Platform.ANDROID
			: proto.ClientPayload.UserAgent.Platform.WEB,

to

		platform: config.browser[1].toLocaleLowerCase().includes('android')
			? proto.ClientPayload.UserAgent.Platform.SMB_ANDROID
			: proto.ClientPayload.UserAgent.Platform.WEB,

This needs to be handled with code rather than posting comments on fixes.

Anyways, the reason this has not gotten an immediate approval from me is due to the lack of safeguards or testing for this in regards to incomplete companion mode support which could increase attack vectors due to lack of implementation

WolfyFlutter · 2025-12-27T23:32:14Z

update : i cant use pairing code with this pr.. qr havent tested yet.
but when i use baileys on npm the pairing code works

justpiple · 2026-01-01T13:26:52Z

Tested and working ✅

Edit: Pairing code doesn’t work properly.

WolfyFlutter · 2026-01-01T14:12:01Z

Tested and working ✅

does it work with pairing code?

github-actions · 2026-01-16T02:17:02Z

This PR is stale because it has been open for 14 days with no activity. Remove the stale label or comment or this will be closed in 14 days

feat: add android browser (can receive viewonce)

38f35fa

vinikjkkj force-pushed the android-browser branch from d049364 to 38f35fa Compare December 19, 2025 04:58

purpshell reviewed Dec 19, 2025

View reviewed changes

canove approved these changes Dec 19, 2025

View reviewed changes

vinikjkkj marked this pull request as draft December 22, 2025 15:17

souravkl11 approved these changes Dec 25, 2025

View reviewed changes

github-actions bot added the Stale label Jan 16, 2026

Uh oh!

feat: add android browser (can receive viewonce) #2201

Are you sure you want to change the base?

feat: add android browser (can receive viewonce) #2201

Conversation

vinikjkkj commented Dec 19, 2025

Uh oh!

whiskeysockets-bot commented Dec 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ How to confirm it works

📦 To test this PR locally:

Uh oh!

WolfyFlutter commented Dec 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

SheIITear commented Dec 19, 2025

Uh oh!

WolfyFlutter commented Dec 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

WolfyFlutter commented Dec 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

purpshell Dec 19, 2025

Choose a reason for hiding this comment

Uh oh!

purpshell Dec 19, 2025

Choose a reason for hiding this comment

Uh oh!

DavidModzz commented Dec 19, 2025

Uh oh!

astrox11 commented Dec 19, 2025

Uh oh!

purpshell commented Dec 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cleitonme commented Dec 20, 2025

Uh oh!

vinikjkkj commented Dec 20, 2025

Uh oh!

vinikjkkj commented Dec 21, 2025

Uh oh!

purpshell commented Dec 22, 2025

Uh oh!

WolfyFlutter commented Dec 27, 2025

Uh oh!

justpiple commented Jan 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

WolfyFlutter commented Jan 1, 2026

Uh oh!

github-actions bot commented Jan 16, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

12 participants

whiskeysockets-bot commented Dec 19, 2025 •

edited

Loading

WolfyFlutter commented Dec 19, 2025 •

edited

Loading

WolfyFlutter commented Dec 19, 2025 •

edited

Loading

WolfyFlutter commented Dec 19, 2025 •

edited

Loading

purpshell commented Dec 19, 2025 •

edited

Loading

justpiple commented Jan 1, 2026 •

edited

Loading