WebKit UserAgent Override - Revision history

Dwc: misc cleanup, added some clarification

2013-07-21T01:40:31Z

misc cleanup, added some clarification

Dkirker at 06:28, 26 August 2012

2012-08-26T06:28:36Z

Dkirker at 04:47, 26 August 2012

2012-08-26T04:47:28Z

Dkirker: /* How to Override the User-Agent */

2012-08-26T04:45:22Z

How to Override the User-Agent

Dkirker at 04:40, 26 August 2012

2012-08-26T04:40:11Z

Dkirker at 04:39, 26 August 2012

2012-08-26T04:39:26Z

Dkirker at 04:38, 26 August 2012

2012-08-26T04:38:56Z

Dkirker at 04:33, 26 August 2012

2012-08-26T04:33:59Z

Dkirker at 19:52, 2 July 2012

2012-07-02T19:52:29Z

Dkirker: Created page with " == What It Is and Does == The user-agent override is a feature that allows one to do a wholesale replacement of the user-agent. == How to Override the User-Agent == The Browser..."

2012-07-02T19:50:35Z

Created page with " == What It Is and Does == The user-agent override is a feature that allows one to do a wholesale replacement of the user-agent. == How to Override the User-Agent == The Browser..."

New page

== What It Is and Does ==
The user-agent override is a feature that allows one to do a wholesale replacement of the user-agent.

== How to Override the User-Agent ==
The BrowserServer loads an instance of WebKit that uses the /etc/palm/browser.conf configuration file.

To change the User-Agent, you need to edit this (/etc/palm/browser.conf) file, with the proper token.

Under the "[General]" section, you will need to add the "UserAgentOverride" key. An example is below:

<pre><nowiki>
[General]
...
UserAgentOverride=Mozilla/5.0 (Windows NT 6.1; WOW64; rv:15.0) Gecko/20120427 Firefox/15.0a1
...
</nowiki></pre>

@@ Line 10: / Line 10: @@
 Under the "[General]"  section, you will need to add the "UserAgentOverride" key. An example is below:
-<pre><nowiki>
+<pre>
 [General]
 ...
 UserAgentOverride=Mozilla/5.0 (Windows NT 6.1; WOW64; rv:15.0) Gecko/20120427 Firefox/15.0a1
 ...
-</nowiki></pre>
+</pre>
 == Ok, great, but this overrides LunaSysMgr, right? ==
@@ Line 22: / Line 22: @@
 = webOS 2.2.4 and earlier =
 == What It Is and What It Does ==
-Earlier versions of webOS do not have a wholesale override feature. It only uses a "token" feature, as described below.
+Earlier versions of webOS do '''not''' have a wholesale override feature. It does, however, have a "tokens" feature, which can '''add''' to your user-agent.
-The WebKit implementation reads the contents of each file in the tokens directory, strips the spaces from it, and then appends this to the user-agent string after a semi-colon. I will describe below how to add these tokens. Some websites may only read "iphone" or "iOS" from the user-agent and think that you have an iPhone.
+The WebKit implementation reads the contents of each file in the tokens directory, strips the spaces from it, and then appends this to the user-agent string after a semi-colon. Some websites may only read "iphone" or "iOS" from the user-agent and think that you have an iPhone.
 == How to add tokens to the User-Agent ==
 # Create a directory somewhere. Either in /etc/palm/ or somewhere in /media/internal/. I created /etc/palm/uatokens/ so that I can create different subdirectories for different types of user agents.
-# Then create a subdirectory for the user-agent you want to try to mimic. For this example, create iphone. You should have /etc/palm/uatokens/iphone/.
+# Create a subdirectory for the user-agent you want to try to mimic. For example, create iphone. You should have /etc/palm/uatokens/iphone/.
-# Then, create the following files, with the following content:
+# For each "token" you want to add, create a file.  For example, to have "<tt>iPhone; Safari/7534.48.3; AppleWebKit/534.46; Version/5.1; Mobile/9A334; CPUiPhoneOS5_0likeMacOSX</tt>" in your user-agent, create the following:
-#* /etc/palm/uatokens/iphone/cpu:<pre><nowiki>CPU iPhone OS 5_0 like Mac OS X</nowiki></pre>
+#* /etc/palm/uatokens/iphone/cpu:<pre>CPU iPhone OS 5_0 like Mac OS X</pre>
-#* /etc/palm/uatokens/iphone/iphone:<pre><nowiki>iPhone</nowiki></pre>
+#* /etc/palm/uatokens/iphone/iphone:<pre>iPhone</pre>
-#* /etc/palm/uatokens/iphone/mobile:<pre><nowiki>Mobile/9A334</nowiki></pre>
+#* /etc/palm/uatokens/iphone/mobile:<pre>Mobile/9A334</pre>
-#* /etc/palm/uatokens/iphone/safari:<pre><nowiki>Safari/7534.48.3</nowiki></pre>
+#* /etc/palm/uatokens/iphone/safari:<pre>Safari/7534.48.3</pre>
-#* /etc/palm/uatokens/iphone/version:<pre><nowiki>Version/5.1</nowiki></pre>
+#* /etc/palm/uatokens/iphone/version:<pre>Version/5.1</pre>
-#* /etc/palm/uatokens/iphone/webkit:<pre><nowiki>AppleWebKit/534.46</nowiki></pre>
+#* /etc/palm/uatokens/iphone/webkit:<pre>AppleWebKit/534.46</pre>
-# Then, edit /etc/palm/browser-app.conf as below (the trailing '/' on the path is MANDATORY):
+# Edit /etc/palm/browser-app.conf as below (the trailing '/' on the path is MANDATORY):
-<pre><nowiki>[General]
+<pre>[General]
 ...
 UserAgentTokensPath=/etc/palm/uatokens/iphone/
 ...
-</nowiki></pre>
+</pre>

← Older revision		Revision as of 06:28, 26 August 2012
Line 52:		Line 52:

	= Platform Independent Notes =		= Platform Independent Notes =
−	LunaSysMgr loads an instance of WebKit, and then reads WebKit settings from /etc/palm/browser.conf. BrowserServer loads another instance of WebKit, and then reads WebKit settings from /etc/palm/browser-app.conf. This is why you can change the User-Agent in one, and not the other.	+	LunaSysMgr loads an instance of WebKit, and then reads WebKit settings from /etc/palm/browser.conf. BrowserServer loads another instance of WebKit, and then reads WebKit settings from /etc/palm/browser-app.conf. This is why you can change the User-Agent in one, and not affect the other.

← Older revision		Revision as of 04:47, 26 August 2012
Line 50:		Line 50:
	== Ok, great, but this overrides LunaSysMgr, right? ==		== Ok, great, but this overrides LunaSysMgr, right? ==
	Nope! LunaSysMgr uses a separate instance of WebKit with different preferences.		Nope! LunaSysMgr uses a separate instance of WebKit with different preferences.
		+
		+	= Platform Independent Notes =
		+	LunaSysMgr loads an instance of WebKit, and then reads WebKit settings from /etc/palm/browser.conf. BrowserServer loads another instance of WebKit, and then reads WebKit settings from /etc/palm/browser-app.conf. This is why you can change the User-Agent in one, and not the other.

@@ Line 36: / Line 36: @@
 #* /etc/palm/uatokens/iphone/version:<pre><nowiki>Version/5.1</nowiki></pre>
 #* /etc/palm/uatokens/iphone/webkit:<pre><nowiki>AppleWebKit/534.46</nowiki></pre>
-# Then, edit /etc/palm/browser-app.conf as below:
+# Then, edit /etc/palm/browser-app.conf as below (the trailing '/' on the path is MANDATORY):
 <pre><nowiki>[General]
@@ Line 43: / Line 43: @@
 ...
 </nowiki></pre>
 Your User-Agent will now look like this (Pre3, with tokens to make it look like an iPhone running iOS 5.1):

@@ Line 36: / Line 36: @@
 #* /etc/palm/uatokens/iphone/version:<pre><nowiki>Version/5.1</nowiki></pre>
 #* /etc/palm/uatokens/iphone/webkit:<pre><nowiki>AppleWebKit/534.46</nowiki></pre>
-# Then, edit /etc/palm/browser-app.conf as below: <pre><nowiki>[General]
+# Then, edit /etc/palm/browser-app.conf as below:
 ...
 UserAgentTokensPath=/etc/palm/uatokens/iphone/
-...</nowiki></pre>
+...
 Your User-Agent will now look like this (Pre3, with tokens to make it look like an iPhone running iOS 5.1):

@@ Line 4: / Line 4: @@
 == How to Override the User-Agent ==
-The BrowserServer loads an instance of WebKit that uses the /etc/palm/browser.conf configuration file.
+The BrowserServer loads an instance of WebKit that uses the /etc/palm/browser-app.conf configuration file.
-To change the User-Agent, you need to edit this (/etc/palm/browser.conf) file, with the proper token.
+To change the User-Agent, you need to edit this (/etc/palm/browser-app.conf) file, with the proper token.
 Under the "[General]"  section, you will need to add the "UserAgentOverride" key. An example is below:

@@ Line 1: / Line 1: @@
+= webOS 3.0.0 and greater =
 == What It Is and What It Does ==
 The user-agent override is a feature that allows one to do a wholesale replacement of the user-agent.
@@ Line 16: / Line 16: @@
 ...
 </nowiki></pre>
 == Ok, great, but this overrides LunaSysMgr, right? ==
 Nope! LunaSysMgr uses a separate instance of WebKit with different preferences.