http://wiki.webos-internals.org/api.php?action=feedcontributions&feedformat=atom&user=DebilaterWebOS Internals - User contributions [en]2026-04-24T07:58:08ZUser contributionsMediaWiki 1.35.1http://wiki.webos-internals.org/index.php?title=SetupSquidTransparentProxy&diff=9095SetupSquidTransparentProxy2010-02-17T18:39:17Z<p>Debilater: /* Make your root disk read-only again */</p>
<hr />
<div>= Squid Transparent Proxy on Palm Pre =<br />
<br />
Ok, someone asked for it, so I figured it out, how to do it for fun and profit:<br />
<br />
== Preparation ==<br />
<br />
First, you need to have root access to your device. How to get root, is described [[Next_steps|here]]. It would be a good idea to know a little about linux and networking too. '''Be warned: this can make your networking unfunctional!'''<br />
<br />
Next thing you need to do is to install the package '''Optware Advanced Linux Command Line Installer''' from Preware, which installs '''ipkg-opt'''!<br />
<br />
== Installing Squid ==<br />
<br />
Login to the pre console and make your root disk writable:<br />
<br />
<source lang="text"><br />
root@palm-webos-device: # cd / && mount -v -o remount,rw /<br />
</source><br />
<br />
Type this command to install the squid optware package<br />
<br />
<source lang="text"><br />
root@palm-webos-device: # ipkg-opt update<br />
...<br />
root@palm-webos-device: # ipkg-opt install squid<br />
Installing squid (2.6.21-2) to root...<br />
Downloading http://ipkg.nslu2-linux.org/feeds/optware/cs08q1armel/cross/unstable/squid_2.6.21-2_arm.ipk<br />
Configuring squid<br />
create default cache and logs dir<br />
chown: unknown user/group nobody:nobody<br />
chown: unknown user/group nobody:nobody<br />
FATAL: Could not determine fully qualified hostname.Please set 'visible_hostname'<br />
<br />
Squid Cache (Version 2.6.STABLE21): Terminated abnormally.<br />
CPU Usage: 0.020 seconds = 0.010 user + 0.010 sys<br />
Maximum Resident Size: 0 KB<br />
Page faults with physical i/o: 0<br />
Segmentation fault<br />
<br />
You should review the configuration file /opt/etc/squid/squid.conf,<br />
make any necessary change, and complete the install by running -<br />
/opt/etc/init.d/S80squid start<br />
<br />
Successfully terminated.<br />
</source><br />
<br />
Ignore the errors for the moment, we'll get to it soon.<br />
<br />
== Create a basic proxy config ==<br />
<br />
Change to the directory '''/opt/etc/squid''' and move the file '''squid.conf''' which is already there to somewhere else. Now create a new squid.conf, which should have the following contents:<br />
<br />
<source lang="text"><br />
visible_hostname localhost<br />
http_port 3128 transparent <br />
hierarchy_stoplist cgi-bin ? <br />
access_log /var/cache/squid/squid.log squid <br />
acl QUERY urlpath_regex cgi-bin \? <br />
cache deny QUERY <br />
<br />
# replace the ip address with the address of your proxy<br />
# replace the port 3128 with the port of your proxy<br />
cache_peer 192.168.2.205 parent 3128 3130 default <br />
<br />
# if your proxy requires authentication, use this:<br />
# cache_peer 192.168.2.205 parent 3128 3130 default login USERNAME PASSWORD<br />
<br />
refresh_pattern ^ftp: 1440 20% 10080<br />
refresh_pattern ^gopher: 1440 0% 1440<br />
refresh_pattern . 0 20% 4320<br />
acl apache rep_header Server ^Apache <br />
broken_vary_encoding allow apache <br />
coredump_dir /var/cache/squid <br />
cache_dir ufs /var/cache/squid 20 5 5<br />
access_log /var/cache/squid/squid.log<br />
cache_log /var/cache/squid/cache.log<br />
cache_store_log /dev/null<br />
<br />
acl all src 0.0.0.0/0.0.0.0<br />
acl manager proto cache_object<br />
acl localhost src 127.0.0.1/255.255.255.255<br />
acl to_localhost dst 127.0.0.0/8<br />
acl SSL_ports port 443<br />
acl Safe_ports port 80 # http<br />
acl Safe_ports port 21 # ftp<br />
acl Safe_ports port 443 # https<br />
acl Safe_ports port 70 # gopher<br />
acl Safe_ports port 210 # wais<br />
acl Safe_ports port 1025-65535 # unregistered ports<br />
acl Safe_ports port 280 # http-mgmt<br />
acl Safe_ports port 488 # gss-http<br />
acl Safe_ports port 591 # filemaker<br />
acl Safe_ports port 777 # multiling http<br />
acl CONNECT method CONNECT<br />
http_access allow manager localhost<br />
http_access deny manager<br />
http_access deny !Safe_ports<br />
http_access deny CONNECT !SSL_ports<br />
# example for an ACL, uncomment and modify<br />
#acl enemy dstdomain www.apple.com<br />
#http_access deny enemy<br />
<br />
http_access allow all<br />
icp_access allow all<br />
<br />
</source><br />
<br />
Basically this is a config for a transparent proxy, thus a browser will be redirected to it without knowing that it is actually connected to a proxy. We must configure it this way because the WebOS browser cannot be configured to use a proxy.<br />
<br />
Note that we have added a single ACL here, which denies access to some random site *g*. Any other requests will be allowed. SSL (HTTPS) will not be passed through the proxy because this requires the browser to connect to it using a proxy request.<br />
<br />
You WILL need to modify the squid.conf variable ''cache_peer'', it points to your upstream proxy, e.g. your companys proxy. Refer to the comments for the syntax.<br />
<br />
== Prepare the directories for squid ==<br />
<br />
Squid needs a directory where to store it's files, as content it caches and logfiles. You may consider to disable caching and logging. But caching may be a good idea if your traffic is limited, so you'll save some. Logging is always usefull for debugging. If you want to turn it off, use '''/dev/null''' as target for the logfiles.<br />
<br />
<source lang="text"><br />
mkdir /var/cache/squid<br />
chown nobody /var/cache/squid<br />
</source><br />
<br />
Next you need let squid to prepare the directory structure using the -z option:<br />
<br />
<source lang="text"><br />
root@palm-webos-device: # squid -z -f squid.conf<br />
2009/11/26 23:19:29| Creating Swap Directories<br />
</source><br />
<br />
You should not see any errors here!<br />
<br />
== Starting squid ==<br />
<br />
The installer already added it to the startup daemons, now we will start it manually:<br />
<br />
<source lang="text"><br />
/opt/etc/init.d/S80squid start<br />
</source><br />
<br />
Look in '''/var/cache/squid/cache.log''' for any errors. Use ps to see if it really runs. You may consider to install '''lynx''' and test the proxy:<br />
<br />
<source lang="text"><br />
ipkg-opt install lynx<br />
export http_proxy=http://localhost:3128<br />
lynx www.google.com<br />
</source><br />
<br />
If you see a google textmode site, it works.<br />
<br />
Turn it off if everything is ok:<br />
<br />
<source lang="text"><br />
/opt/etc/init.d/S80squid stop<br />
</source><br />
<br />
== Add the rules to the squid startup file ==<br />
<br />
Now comes the ugly part. I'll not explain it in detail: we install some iptable Rules. We tell iptables to forward any traffic destined to tcp port 80 to localhost port 3128 (this is where squid listens for incoming connections). To avoid that the requests of the proxy itself are forwarded to localhost (which would create a loop), we add a rule telling iptables to not forward web traffic if it were generated by user nobody (the user squid runs as).<br />
<br />
To do that, edit '''/opt/etc/init.d/S80squid''' so that it looks like this:<br />
<source lang="text"><br />
#! /bin/sh<br />
<br />
case "$1" in<br />
start)<br />
echo -n "Starting proxy server: "<br />
if [ -n "`pidof quotacheck`" ]; then<br />
#you don't need it if you don't have quota check enable.<br />
echo "Starting squid-cache server after delay for few mins:"<br />
/opt/etc/squid/squid.delay-start.sh&amp;<br />
else<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf<br />
iptables -t nat -A OUTPUT -p tcp --dport 80 -m owner --gid-owner 65534 -j ACCEPT<br />
iptables -t nat -A OUTPUT -p tcp --dport 80 -j DNAT --to-destination 127.0.0.1:3128<br />
echo "done."<br />
fi<br />
echo "done."<br />
;;<br />
stop)<br />
echo -n "Stopping proxy server: "<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf -k shutdown<br />
iptables -t nat -D OUTPUT -p tcp --dport 80 -m owner --gid-owner 65534 -j ACCEPT<br />
iptables -t nat -D OUTPUT -p tcp --dport 80 -j DNAT --to-destination 127.0.0.1:3128<br />
echo "done."<br />
;;<br />
reload|force-reload)<br />
echo -n "Reloading proxy server configuration files: "<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf -k reconfigure<br />
echo "done."<br />
;;<br />
restart)<br />
echo -n "Restarting proxy server: "<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf -k shutdown<br />
sleep 2<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf<br />
echo "done."<br />
;;<br />
*)<br />
echo "Usage: /opt/etc/init.d/S80squid {start|stop|reload|force-reload|restart}"<br />
exit 1<br />
;;<br />
esac<br />
</source><br />
<br />
== Configure network to startup squid if WIFI comes up ==<br />
<br />
Now we need to alter the behavior of the palm network manager so that it starts squid if WIFI comes up and stops it when WIFI goes down.<br />
<br />
Change to directory '''/etc/pmnetconfig/'''.<br />
<br />
In the file '''if-up''' modify this part:<br />
<br />
<source lang="text"><br />
if [ "$ISPPP" -ne 4 ] &amp;&amp; [ "$ISRMNET" -ne 6 ] &amp;&amp; [ "$ISTUN" -ne 4 ] &amp;&amp; [ "$ISCSCOTUNVPN" -ne 8 ]; then<br />
NetCfgSetAddr<br />
CMSERVICES=$((${CMSERVICES} | ${CMSVCINTERNET}))<br />
fi<br />
</source><br />
<br />
to<br />
<br />
<source lang="text"><br />
if [ "$ISPPP" -ne 4 ] &amp;&amp; [ "$ISRMNET" -ne 6 ] &amp;&amp; [ "$ISTUN" -ne 4 ] &amp;&amp; [ "$ISCSCOTUNVPN" -ne 8 ]; then<br />
NetCfgSetAddr<br />
CMSERVICES=$((${CMSERVICES} | ${CMSVCINTERNET}))<br />
/usr/bin/logger "wifi up: execute /opt/etc/init.d/S80squid start" <br />
/opt/etc/init.d/S80squid start<br />
fi<br />
</source><br />
<br />
In the file '''if-down''' modify this part:<br />
<br />
<source lang="text"><br />
if [ ${CMINTERFACE} = ${CMBTINTERFACENAME} ] || [ ${CMINTERFACE} = ${CMBRINTERFACENAME} ]; then<br />
${LOG} "${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE"<br />
${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE<br />
${LOG} "${ECHO} 0 >/proc/sys/net/ipv4/ip_forward"<br />
${ECHO} 0 >/proc/sys/net/ipv4/ip_forward<br />
fi <br />
</source><br />
<br />
to:<br />
<br />
<source lang="text"><br />
if [ ${CMINTERFACE} = ${CMBTINTERFACENAME} ] || [ ${CMINTERFACE} = ${CMBRINTERFACENAME} ]; then<br />
${LOG} "${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE"<br />
${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE<br />
${LOG} "${ECHO} 0 >/proc/sys/net/ipv4/ip_forward"<br />
${ECHO} 0 >/proc/sys/net/ipv4/ip_forward<br />
/usr/bin/logger "wifi up: execute /opt/etc/init.d/S80squid stop" <br />
/opt/etc/init.d/S80squid stop <br />
fi <br />
</source><br />
<br />
== Make your root disk read-only again ==<br />
<br />
<source lang="text"><br />
root@palm-webos-device: # cd / && mount -v -o remount,ro /<br />
</source><br />
<br />
== See it working ==<br />
<br />
So, let's see how it works. Enable WIFI and fire up the browser and see if it works. You should see your requests on the remote proxy.<br />
<br />
If you added an ACL as mentioned earlier, a message like the following should appear if you enter the url of your favourite enemy vendor (the one we configured above):<br />
<br />
[[Image:Squid-access-denied-palm-pre.png]]<br />
<br />
== Blocking Adverts ==<br />
<br />
Now squid is set up, we can use it for ad blocking. There are two steps to this:<br />
<br />
=== Obtain a block list ===<br />
<br />
An excellent ad block list is maintained at [http://pgl.yoyo.org/as/]. We need to download it in a suitable format for squid, which can be done by running the following command:<br />
<br />
<source lang="text"><br />
wget -q -O - 'http://pgl.yoyo.org/as/serverlist.php?hostformat=squid-dstdom-regex;showintro=0' | grep -v ">" | grep "." > /opt/etc/squid/blocklist<br />
</source><br />
<br />
(Technical details: the wget command downloads the URL given in single quotes, then we strip the HTML mark-up and blank lines using grep. The filename at the end is where the black list will be stored.)<br />
<br />
=== Configure squid to use the block list ===<br />
<br />
Now we need to tell squid to block the list of URLs in the file we've just created. Open the ''/opt/etc/squid/squid.conf'' file we created above, and scroll down to where it reads:<br />
<br />
<source lang="text"><br />
acl enemy dstdomain www.apple.com<br />
</source><br />
<br />
Replace this line with:<br />
<br />
<source lang="text"><br />
acl enemy dstdom_regex "/opt/etc/squid/blocklist"<br />
</source><br />
<br />
Finally, restart squid:<br />
<br />
<source lang="text"><br />
/opt/etc/init.d/S80squid restart<br />
</source><br />
<br />
To test it's working, open a browser and try to visit ''ads.msn.com'' (one of the blocked URLs). The error given should be similar to the screenshot given above.<br />
<br />
If in the future you need to update the ad blocking list, run the commands:<br />
<br />
<source lang="text"><br />
cd / && mount -v -o remount,rw /<br />
wget -q -O - 'http://pgl.yoyo.org/as/serverlist.php?hostformat=squid-dstdom-regex;showintro=0' | grep -v ">" | grep "." > /opt/etc/squid/blocklist<br />
/opt/etc/init.d/S80squid restart<br />
</source><br />
<br />
For further details of filtering URLs using squid, please refer to the [http://www.squid-cache.org/Doc/ excelent documentation of the squid cache project].</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=SetupSquidTransparentProxy&diff=9094SetupSquidTransparentProxy2010-02-17T18:37:49Z<p>Debilater: /* Configure network to startup squid if WIFI comes up */</p>
<hr />
<div>= Squid Transparent Proxy on Palm Pre =<br />
<br />
Ok, someone asked for it, so I figured it out, how to do it for fun and profit:<br />
<br />
== Preparation ==<br />
<br />
First, you need to have root access to your device. How to get root, is described [[Next_steps|here]]. It would be a good idea to know a little about linux and networking too. '''Be warned: this can make your networking unfunctional!'''<br />
<br />
Next thing you need to do is to install the package '''Optware Advanced Linux Command Line Installer''' from Preware, which installs '''ipkg-opt'''!<br />
<br />
== Installing Squid ==<br />
<br />
Login to the pre console and make your root disk writable:<br />
<br />
<source lang="text"><br />
root@palm-webos-device: # cd / && mount -v -o remount,rw /<br />
</source><br />
<br />
Type this command to install the squid optware package<br />
<br />
<source lang="text"><br />
root@palm-webos-device: # ipkg-opt update<br />
...<br />
root@palm-webos-device: # ipkg-opt install squid<br />
Installing squid (2.6.21-2) to root...<br />
Downloading http://ipkg.nslu2-linux.org/feeds/optware/cs08q1armel/cross/unstable/squid_2.6.21-2_arm.ipk<br />
Configuring squid<br />
create default cache and logs dir<br />
chown: unknown user/group nobody:nobody<br />
chown: unknown user/group nobody:nobody<br />
FATAL: Could not determine fully qualified hostname.Please set 'visible_hostname'<br />
<br />
Squid Cache (Version 2.6.STABLE21): Terminated abnormally.<br />
CPU Usage: 0.020 seconds = 0.010 user + 0.010 sys<br />
Maximum Resident Size: 0 KB<br />
Page faults with physical i/o: 0<br />
Segmentation fault<br />
<br />
You should review the configuration file /opt/etc/squid/squid.conf,<br />
make any necessary change, and complete the install by running -<br />
/opt/etc/init.d/S80squid start<br />
<br />
Successfully terminated.<br />
</source><br />
<br />
Ignore the errors for the moment, we'll get to it soon.<br />
<br />
== Create a basic proxy config ==<br />
<br />
Change to the directory '''/opt/etc/squid''' and move the file '''squid.conf''' which is already there to somewhere else. Now create a new squid.conf, which should have the following contents:<br />
<br />
<source lang="text"><br />
visible_hostname localhost<br />
http_port 3128 transparent <br />
hierarchy_stoplist cgi-bin ? <br />
access_log /var/cache/squid/squid.log squid <br />
acl QUERY urlpath_regex cgi-bin \? <br />
cache deny QUERY <br />
<br />
# replace the ip address with the address of your proxy<br />
# replace the port 3128 with the port of your proxy<br />
cache_peer 192.168.2.205 parent 3128 3130 default <br />
<br />
# if your proxy requires authentication, use this:<br />
# cache_peer 192.168.2.205 parent 3128 3130 default login USERNAME PASSWORD<br />
<br />
refresh_pattern ^ftp: 1440 20% 10080<br />
refresh_pattern ^gopher: 1440 0% 1440<br />
refresh_pattern . 0 20% 4320<br />
acl apache rep_header Server ^Apache <br />
broken_vary_encoding allow apache <br />
coredump_dir /var/cache/squid <br />
cache_dir ufs /var/cache/squid 20 5 5<br />
access_log /var/cache/squid/squid.log<br />
cache_log /var/cache/squid/cache.log<br />
cache_store_log /dev/null<br />
<br />
acl all src 0.0.0.0/0.0.0.0<br />
acl manager proto cache_object<br />
acl localhost src 127.0.0.1/255.255.255.255<br />
acl to_localhost dst 127.0.0.0/8<br />
acl SSL_ports port 443<br />
acl Safe_ports port 80 # http<br />
acl Safe_ports port 21 # ftp<br />
acl Safe_ports port 443 # https<br />
acl Safe_ports port 70 # gopher<br />
acl Safe_ports port 210 # wais<br />
acl Safe_ports port 1025-65535 # unregistered ports<br />
acl Safe_ports port 280 # http-mgmt<br />
acl Safe_ports port 488 # gss-http<br />
acl Safe_ports port 591 # filemaker<br />
acl Safe_ports port 777 # multiling http<br />
acl CONNECT method CONNECT<br />
http_access allow manager localhost<br />
http_access deny manager<br />
http_access deny !Safe_ports<br />
http_access deny CONNECT !SSL_ports<br />
# example for an ACL, uncomment and modify<br />
#acl enemy dstdomain www.apple.com<br />
#http_access deny enemy<br />
<br />
http_access allow all<br />
icp_access allow all<br />
<br />
</source><br />
<br />
Basically this is a config for a transparent proxy, thus a browser will be redirected to it without knowing that it is actually connected to a proxy. We must configure it this way because the WebOS browser cannot be configured to use a proxy.<br />
<br />
Note that we have added a single ACL here, which denies access to some random site *g*. Any other requests will be allowed. SSL (HTTPS) will not be passed through the proxy because this requires the browser to connect to it using a proxy request.<br />
<br />
You WILL need to modify the squid.conf variable ''cache_peer'', it points to your upstream proxy, e.g. your companys proxy. Refer to the comments for the syntax.<br />
<br />
== Prepare the directories for squid ==<br />
<br />
Squid needs a directory where to store it's files, as content it caches and logfiles. You may consider to disable caching and logging. But caching may be a good idea if your traffic is limited, so you'll save some. Logging is always usefull for debugging. If you want to turn it off, use '''/dev/null''' as target for the logfiles.<br />
<br />
<source lang="text"><br />
mkdir /var/cache/squid<br />
chown nobody /var/cache/squid<br />
</source><br />
<br />
Next you need let squid to prepare the directory structure using the -z option:<br />
<br />
<source lang="text"><br />
root@palm-webos-device: # squid -z -f squid.conf<br />
2009/11/26 23:19:29| Creating Swap Directories<br />
</source><br />
<br />
You should not see any errors here!<br />
<br />
== Starting squid ==<br />
<br />
The installer already added it to the startup daemons, now we will start it manually:<br />
<br />
<source lang="text"><br />
/opt/etc/init.d/S80squid start<br />
</source><br />
<br />
Look in '''/var/cache/squid/cache.log''' for any errors. Use ps to see if it really runs. You may consider to install '''lynx''' and test the proxy:<br />
<br />
<source lang="text"><br />
ipkg-opt install lynx<br />
export http_proxy=http://localhost:3128<br />
lynx www.google.com<br />
</source><br />
<br />
If you see a google textmode site, it works.<br />
<br />
Turn it off if everything is ok:<br />
<br />
<source lang="text"><br />
/opt/etc/init.d/S80squid stop<br />
</source><br />
<br />
== Add the rules to the squid startup file ==<br />
<br />
Now comes the ugly part. I'll not explain it in detail: we install some iptable Rules. We tell iptables to forward any traffic destined to tcp port 80 to localhost port 3128 (this is where squid listens for incoming connections). To avoid that the requests of the proxy itself are forwarded to localhost (which would create a loop), we add a rule telling iptables to not forward web traffic if it were generated by user nobody (the user squid runs as).<br />
<br />
To do that, edit '''/opt/etc/init.d/S80squid''' so that it looks like this:<br />
<source lang="text"><br />
#! /bin/sh<br />
<br />
case "$1" in<br />
start)<br />
echo -n "Starting proxy server: "<br />
if [ -n "`pidof quotacheck`" ]; then<br />
#you don't need it if you don't have quota check enable.<br />
echo "Starting squid-cache server after delay for few mins:"<br />
/opt/etc/squid/squid.delay-start.sh&amp;<br />
else<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf<br />
iptables -t nat -A OUTPUT -p tcp --dport 80 -m owner --gid-owner 65534 -j ACCEPT<br />
iptables -t nat -A OUTPUT -p tcp --dport 80 -j DNAT --to-destination 127.0.0.1:3128<br />
echo "done."<br />
fi<br />
echo "done."<br />
;;<br />
stop)<br />
echo -n "Stopping proxy server: "<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf -k shutdown<br />
iptables -t nat -D OUTPUT -p tcp --dport 80 -m owner --gid-owner 65534 -j ACCEPT<br />
iptables -t nat -D OUTPUT -p tcp --dport 80 -j DNAT --to-destination 127.0.0.1:3128<br />
echo "done."<br />
;;<br />
reload|force-reload)<br />
echo -n "Reloading proxy server configuration files: "<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf -k reconfigure<br />
echo "done."<br />
;;<br />
restart)<br />
echo -n "Restarting proxy server: "<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf -k shutdown<br />
sleep 2<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf<br />
echo "done."<br />
;;<br />
*)<br />
echo "Usage: /opt/etc/init.d/S80squid {start|stop|reload|force-reload|restart}"<br />
exit 1<br />
;;<br />
esac<br />
</source><br />
<br />
== Configure network to startup squid if WIFI comes up ==<br />
<br />
Now we need to alter the behavior of the palm network manager so that it starts squid if WIFI comes up and stops it when WIFI goes down.<br />
<br />
Change to directory '''/etc/pmnetconfig/'''.<br />
<br />
In the file '''if-up''' modify this part:<br />
<br />
<source lang="text"><br />
if [ "$ISPPP" -ne 4 ] &amp;&amp; [ "$ISRMNET" -ne 6 ] &amp;&amp; [ "$ISTUN" -ne 4 ] &amp;&amp; [ "$ISCSCOTUNVPN" -ne 8 ]; then<br />
NetCfgSetAddr<br />
CMSERVICES=$((${CMSERVICES} | ${CMSVCINTERNET}))<br />
fi<br />
</source><br />
<br />
to<br />
<br />
<source lang="text"><br />
if [ "$ISPPP" -ne 4 ] &amp;&amp; [ "$ISRMNET" -ne 6 ] &amp;&amp; [ "$ISTUN" -ne 4 ] &amp;&amp; [ "$ISCSCOTUNVPN" -ne 8 ]; then<br />
NetCfgSetAddr<br />
CMSERVICES=$((${CMSERVICES} | ${CMSVCINTERNET}))<br />
/usr/bin/logger "wifi up: execute /opt/etc/init.d/S80squid start" <br />
/opt/etc/init.d/S80squid start<br />
fi<br />
</source><br />
<br />
In the file '''if-down''' modify this part:<br />
<br />
<source lang="text"><br />
if [ ${CMINTERFACE} = ${CMBTINTERFACENAME} ] || [ ${CMINTERFACE} = ${CMBRINTERFACENAME} ]; then<br />
${LOG} "${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE"<br />
${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE<br />
${LOG} "${ECHO} 0 >/proc/sys/net/ipv4/ip_forward"<br />
${ECHO} 0 >/proc/sys/net/ipv4/ip_forward<br />
fi <br />
</source><br />
<br />
to:<br />
<br />
<source lang="text"><br />
if [ ${CMINTERFACE} = ${CMBTINTERFACENAME} ] || [ ${CMINTERFACE} = ${CMBRINTERFACENAME} ]; then<br />
${LOG} "${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE"<br />
${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE<br />
${LOG} "${ECHO} 0 >/proc/sys/net/ipv4/ip_forward"<br />
${ECHO} 0 >/proc/sys/net/ipv4/ip_forward<br />
/usr/bin/logger "wifi up: execute /opt/etc/init.d/S80squid stop" <br />
/opt/etc/init.d/S80squid stop <br />
fi <br />
</source><br />
<br />
== Make your root disk read-only again ==<br />
<br />
<source lang="text"><br />
root@palm-webos-device: # cd / && mount -v -o remount,ro /<br />
</source<br />
<br />
== See it working ==<br />
<br />
So, let's see how it works. Enable WIFI and fire up the browser and see if it works. You should see your requests on the remote proxy.<br />
<br />
If you added an ACL as mentioned earlier, a message like the following should appear if you enter the url of your favourite enemy vendor (the one we configured above):<br />
<br />
[[Image:Squid-access-denied-palm-pre.png]]<br />
<br />
== Blocking Adverts ==<br />
<br />
Now squid is set up, we can use it for ad blocking. There are two steps to this:<br />
<br />
=== Obtain a block list ===<br />
<br />
An excellent ad block list is maintained at [http://pgl.yoyo.org/as/]. We need to download it in a suitable format for squid, which can be done by running the following command:<br />
<br />
<source lang="text"><br />
wget -q -O - 'http://pgl.yoyo.org/as/serverlist.php?hostformat=squid-dstdom-regex;showintro=0' | grep -v ">" | grep "." > /opt/etc/squid/blocklist<br />
</source><br />
<br />
(Technical details: the wget command downloads the URL given in single quotes, then we strip the HTML mark-up and blank lines using grep. The filename at the end is where the black list will be stored.)<br />
<br />
=== Configure squid to use the block list ===<br />
<br />
Now we need to tell squid to block the list of URLs in the file we've just created. Open the ''/opt/etc/squid/squid.conf'' file we created above, and scroll down to where it reads:<br />
<br />
<source lang="text"><br />
acl enemy dstdomain www.apple.com<br />
</source><br />
<br />
Replace this line with:<br />
<br />
<source lang="text"><br />
acl enemy dstdom_regex "/opt/etc/squid/blocklist"<br />
</source><br />
<br />
Finally, restart squid:<br />
<br />
<source lang="text"><br />
/opt/etc/init.d/S80squid restart<br />
</source><br />
<br />
To test it's working, open a browser and try to visit ''ads.msn.com'' (one of the blocked URLs). The error given should be similar to the screenshot given above.<br />
<br />
If in the future you need to update the ad blocking list, run the commands:<br />
<br />
<source lang="text"><br />
cd / && mount -v -o remount,rw /<br />
wget -q -O - 'http://pgl.yoyo.org/as/serverlist.php?hostformat=squid-dstdom-regex;showintro=0' | grep -v ">" | grep "." > /opt/etc/squid/blocklist<br />
/opt/etc/init.d/S80squid restart<br />
</source><br />
<br />
For further details of filtering URLs using squid, please refer to the [http://www.squid-cache.org/Doc/ excelent documentation of the squid cache project].</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=SetupSquidTransparentProxy&diff=9093SetupSquidTransparentProxy2010-02-17T18:36:23Z<p>Debilater: /* Configure network to startup squid if WLAN comes up */</p>
<hr />
<div>= Squid Transparent Proxy on Palm Pre =<br />
<br />
Ok, someone asked for it, so I figured it out, how to do it for fun and profit:<br />
<br />
== Preparation ==<br />
<br />
First, you need to have root access to your device. How to get root, is described [[Next_steps|here]]. It would be a good idea to know a little about linux and networking too. '''Be warned: this can make your networking unfunctional!'''<br />
<br />
Next thing you need to do is to install the package '''Optware Advanced Linux Command Line Installer''' from Preware, which installs '''ipkg-opt'''!<br />
<br />
== Installing Squid ==<br />
<br />
Login to the pre console and make your root disk writable:<br />
<br />
<source lang="text"><br />
root@palm-webos-device: # cd / && mount -v -o remount,rw /<br />
</source><br />
<br />
Type this command to install the squid optware package<br />
<br />
<source lang="text"><br />
root@palm-webos-device: # ipkg-opt update<br />
...<br />
root@palm-webos-device: # ipkg-opt install squid<br />
Installing squid (2.6.21-2) to root...<br />
Downloading http://ipkg.nslu2-linux.org/feeds/optware/cs08q1armel/cross/unstable/squid_2.6.21-2_arm.ipk<br />
Configuring squid<br />
create default cache and logs dir<br />
chown: unknown user/group nobody:nobody<br />
chown: unknown user/group nobody:nobody<br />
FATAL: Could not determine fully qualified hostname.Please set 'visible_hostname'<br />
<br />
Squid Cache (Version 2.6.STABLE21): Terminated abnormally.<br />
CPU Usage: 0.020 seconds = 0.010 user + 0.010 sys<br />
Maximum Resident Size: 0 KB<br />
Page faults with physical i/o: 0<br />
Segmentation fault<br />
<br />
You should review the configuration file /opt/etc/squid/squid.conf,<br />
make any necessary change, and complete the install by running -<br />
/opt/etc/init.d/S80squid start<br />
<br />
Successfully terminated.<br />
</source><br />
<br />
Ignore the errors for the moment, we'll get to it soon.<br />
<br />
== Create a basic proxy config ==<br />
<br />
Change to the directory '''/opt/etc/squid''' and move the file '''squid.conf''' which is already there to somewhere else. Now create a new squid.conf, which should have the following contents:<br />
<br />
<source lang="text"><br />
visible_hostname localhost<br />
http_port 3128 transparent <br />
hierarchy_stoplist cgi-bin ? <br />
access_log /var/cache/squid/squid.log squid <br />
acl QUERY urlpath_regex cgi-bin \? <br />
cache deny QUERY <br />
<br />
# replace the ip address with the address of your proxy<br />
# replace the port 3128 with the port of your proxy<br />
cache_peer 192.168.2.205 parent 3128 3130 default <br />
<br />
# if your proxy requires authentication, use this:<br />
# cache_peer 192.168.2.205 parent 3128 3130 default login USERNAME PASSWORD<br />
<br />
refresh_pattern ^ftp: 1440 20% 10080<br />
refresh_pattern ^gopher: 1440 0% 1440<br />
refresh_pattern . 0 20% 4320<br />
acl apache rep_header Server ^Apache <br />
broken_vary_encoding allow apache <br />
coredump_dir /var/cache/squid <br />
cache_dir ufs /var/cache/squid 20 5 5<br />
access_log /var/cache/squid/squid.log<br />
cache_log /var/cache/squid/cache.log<br />
cache_store_log /dev/null<br />
<br />
acl all src 0.0.0.0/0.0.0.0<br />
acl manager proto cache_object<br />
acl localhost src 127.0.0.1/255.255.255.255<br />
acl to_localhost dst 127.0.0.0/8<br />
acl SSL_ports port 443<br />
acl Safe_ports port 80 # http<br />
acl Safe_ports port 21 # ftp<br />
acl Safe_ports port 443 # https<br />
acl Safe_ports port 70 # gopher<br />
acl Safe_ports port 210 # wais<br />
acl Safe_ports port 1025-65535 # unregistered ports<br />
acl Safe_ports port 280 # http-mgmt<br />
acl Safe_ports port 488 # gss-http<br />
acl Safe_ports port 591 # filemaker<br />
acl Safe_ports port 777 # multiling http<br />
acl CONNECT method CONNECT<br />
http_access allow manager localhost<br />
http_access deny manager<br />
http_access deny !Safe_ports<br />
http_access deny CONNECT !SSL_ports<br />
# example for an ACL, uncomment and modify<br />
#acl enemy dstdomain www.apple.com<br />
#http_access deny enemy<br />
<br />
http_access allow all<br />
icp_access allow all<br />
<br />
</source><br />
<br />
Basically this is a config for a transparent proxy, thus a browser will be redirected to it without knowing that it is actually connected to a proxy. We must configure it this way because the WebOS browser cannot be configured to use a proxy.<br />
<br />
Note that we have added a single ACL here, which denies access to some random site *g*. Any other requests will be allowed. SSL (HTTPS) will not be passed through the proxy because this requires the browser to connect to it using a proxy request.<br />
<br />
You WILL need to modify the squid.conf variable ''cache_peer'', it points to your upstream proxy, e.g. your companys proxy. Refer to the comments for the syntax.<br />
<br />
== Prepare the directories for squid ==<br />
<br />
Squid needs a directory where to store it's files, as content it caches and logfiles. You may consider to disable caching and logging. But caching may be a good idea if your traffic is limited, so you'll save some. Logging is always usefull for debugging. If you want to turn it off, use '''/dev/null''' as target for the logfiles.<br />
<br />
<source lang="text"><br />
mkdir /var/cache/squid<br />
chown nobody /var/cache/squid<br />
</source><br />
<br />
Next you need let squid to prepare the directory structure using the -z option:<br />
<br />
<source lang="text"><br />
root@palm-webos-device: # squid -z -f squid.conf<br />
2009/11/26 23:19:29| Creating Swap Directories<br />
</source><br />
<br />
You should not see any errors here!<br />
<br />
== Starting squid ==<br />
<br />
The installer already added it to the startup daemons, now we will start it manually:<br />
<br />
<source lang="text"><br />
/opt/etc/init.d/S80squid start<br />
</source><br />
<br />
Look in '''/var/cache/squid/cache.log''' for any errors. Use ps to see if it really runs. You may consider to install '''lynx''' and test the proxy:<br />
<br />
<source lang="text"><br />
ipkg-opt install lynx<br />
export http_proxy=http://localhost:3128<br />
lynx www.google.com<br />
</source><br />
<br />
If you see a google textmode site, it works.<br />
<br />
Turn it off if everything is ok:<br />
<br />
<source lang="text"><br />
/opt/etc/init.d/S80squid stop<br />
</source><br />
<br />
== Add the rules to the squid startup file ==<br />
<br />
Now comes the ugly part. I'll not explain it in detail: we install some iptable Rules. We tell iptables to forward any traffic destined to tcp port 80 to localhost port 3128 (this is where squid listens for incoming connections). To avoid that the requests of the proxy itself are forwarded to localhost (which would create a loop), we add a rule telling iptables to not forward web traffic if it were generated by user nobody (the user squid runs as).<br />
<br />
To do that, edit '''/opt/etc/init.d/S80squid''' so that it looks like this:<br />
<source lang="text"><br />
#! /bin/sh<br />
<br />
case "$1" in<br />
start)<br />
echo -n "Starting proxy server: "<br />
if [ -n "`pidof quotacheck`" ]; then<br />
#you don't need it if you don't have quota check enable.<br />
echo "Starting squid-cache server after delay for few mins:"<br />
/opt/etc/squid/squid.delay-start.sh&amp;<br />
else<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf<br />
iptables -t nat -A OUTPUT -p tcp --dport 80 -m owner --gid-owner 65534 -j ACCEPT<br />
iptables -t nat -A OUTPUT -p tcp --dport 80 -j DNAT --to-destination 127.0.0.1:3128<br />
echo "done."<br />
fi<br />
echo "done."<br />
;;<br />
stop)<br />
echo -n "Stopping proxy server: "<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf -k shutdown<br />
iptables -t nat -D OUTPUT -p tcp --dport 80 -m owner --gid-owner 65534 -j ACCEPT<br />
iptables -t nat -D OUTPUT -p tcp --dport 80 -j DNAT --to-destination 127.0.0.1:3128<br />
echo "done."<br />
;;<br />
reload|force-reload)<br />
echo -n "Reloading proxy server configuration files: "<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf -k reconfigure<br />
echo "done."<br />
;;<br />
restart)<br />
echo -n "Restarting proxy server: "<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf -k shutdown<br />
sleep 2<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf<br />
echo "done."<br />
;;<br />
*)<br />
echo "Usage: /opt/etc/init.d/S80squid {start|stop|reload|force-reload|restart}"<br />
exit 1<br />
;;<br />
esac<br />
</source><br />
<br />
== Configure network to startup squid if WIFI comes up ==<br />
<br />
Now we need to alter the behavior of the palm network manager so that it starts squid if WIFI comes up and stops it when WIFI goes down.<br />
<br />
Change to directory '''/etc/pmnetconfig/'''.<br />
<br />
In the file '''if-up''' modify this part:<br />
<br />
<source lang="text"<br />
if [ "$ISPPP" -ne 4 ] &amp;&amp; [ "$ISRMNET" -ne 6 ] &amp;&amp; [ "$ISTUN" -ne 4 ] &amp;&amp; [ "$ISCSCOTUNVPN" -ne 8 ]; then<br />
NetCfgSetAddr<br />
CMSERVICES=$((${CMSERVICES} | ${CMSVCINTERNET}))<br />
fi<br />
</source><br />
<br />
to<br />
<br />
<source lang="text"<br />
if [ "$ISPPP" -ne 4 ] &amp;&amp; [ "$ISRMNET" -ne 6 ] &amp;&amp; [ "$ISTUN" -ne 4 ] &amp;&amp; [ "$ISCSCOTUNVPN" -ne 8 ]; then<br />
NetCfgSetAddr<br />
CMSERVICES=$((${CMSERVICES} | ${CMSVCINTERNET}))<br />
/usr/bin/logger "wifi up: execute /opt/etc/init.d/S80squid start" <br />
/opt/etc/init.d/S80squid start<br />
fi<br />
</source><br />
<br />
In the file '''if-down''' modify this part:<br />
<br />
<source lang="text"<br />
if [ ${CMINTERFACE} = ${CMBTINTERFACENAME} ] || [ ${CMINTERFACE} = ${CMBRINTERFACENAME} ]; then<br />
${LOG} "${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE"<br />
${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE<br />
${LOG} "${ECHO} 0 >/proc/sys/net/ipv4/ip_forward"<br />
${ECHO} 0 >/proc/sys/net/ipv4/ip_forward<br />
fi <br />
</source><br />
<br />
to:<br />
<br />
<source lang="text"<br />
if [ ${CMINTERFACE} = ${CMBTINTERFACENAME} ] || [ ${CMINTERFACE} = ${CMBRINTERFACENAME} ]; then<br />
${LOG} "${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE"<br />
${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE<br />
${LOG} "${ECHO} 0 >/proc/sys/net/ipv4/ip_forward"<br />
${ECHO} 0 >/proc/sys/net/ipv4/ip_forward<br />
/usr/bin/logger "wifi up: execute /opt/etc/init.d/S80squid stop" <br />
/opt/etc/init.d/S80squid stop <br />
fi <br />
</source><br />
<br />
== See it working ==<br />
<br />
So, let's see how it works. Enable WIFI and fire up the browser and see if it works. You should see your requests on the remote proxy.<br />
<br />
If you added an ACL as mentioned earlier, a message like the following should appear if you enter the url of your favourite enemy vendor (the one we configured above):<br />
<br />
[[Image:Squid-access-denied-palm-pre.png]]<br />
<br />
== Blocking Adverts ==<br />
<br />
Now squid is set up, we can use it for ad blocking. There are two steps to this:<br />
<br />
=== Obtain a block list ===<br />
<br />
An excellent ad block list is maintained at [http://pgl.yoyo.org/as/]. We need to download it in a suitable format for squid, which can be done by running the following command:<br />
<br />
<source lang="text"><br />
wget -q -O - 'http://pgl.yoyo.org/as/serverlist.php?hostformat=squid-dstdom-regex;showintro=0' | grep -v ">" | grep "." > /opt/etc/squid/blocklist<br />
</source><br />
<br />
(Technical details: the wget command downloads the URL given in single quotes, then we strip the HTML mark-up and blank lines using grep. The filename at the end is where the black list will be stored.)<br />
<br />
=== Configure squid to use the block list ===<br />
<br />
Now we need to tell squid to block the list of URLs in the file we've just created. Open the ''/opt/etc/squid/squid.conf'' file we created above, and scroll down to where it reads:<br />
<br />
<source lang="text"><br />
acl enemy dstdomain www.apple.com<br />
</source><br />
<br />
Replace this line with:<br />
<br />
<source lang="text"><br />
acl enemy dstdom_regex "/opt/etc/squid/blocklist"<br />
</source><br />
<br />
Finally, restart squid:<br />
<br />
<source lang="text"><br />
/opt/etc/init.d/S80squid restart<br />
</source><br />
<br />
To test it's working, open a browser and try to visit ''ads.msn.com'' (one of the blocked URLs). The error given should be similar to the screenshot given above.<br />
<br />
If in the future you need to update the ad blocking list, run the commands:<br />
<br />
<source lang="text"><br />
cd / && mount -v -o remount,rw /<br />
wget -q -O - 'http://pgl.yoyo.org/as/serverlist.php?hostformat=squid-dstdom-regex;showintro=0' | grep -v ">" | grep "." > /opt/etc/squid/blocklist<br />
/opt/etc/init.d/S80squid restart<br />
</source><br />
<br />
For further details of filtering URLs using squid, please refer to the [http://www.squid-cache.org/Doc/ excelent documentation of the squid cache project].</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=SetupSquidTransparentProxy&diff=9092SetupSquidTransparentProxy2010-02-17T18:35:03Z<p>Debilater: /* Add the rules to the squid startup file */</p>
<hr />
<div>= Squid Transparent Proxy on Palm Pre =<br />
<br />
Ok, someone asked for it, so I figured it out, how to do it for fun and profit:<br />
<br />
== Preparation ==<br />
<br />
First, you need to have root access to your device. How to get root, is described [[Next_steps|here]]. It would be a good idea to know a little about linux and networking too. '''Be warned: this can make your networking unfunctional!'''<br />
<br />
Next thing you need to do is to install the package '''Optware Advanced Linux Command Line Installer''' from Preware, which installs '''ipkg-opt'''!<br />
<br />
== Installing Squid ==<br />
<br />
Login to the pre console and make your root disk writable:<br />
<br />
<source lang="text"><br />
root@palm-webos-device: # cd / && mount -v -o remount,rw /<br />
</source><br />
<br />
Type this command to install the squid optware package<br />
<br />
<source lang="text"><br />
root@palm-webos-device: # ipkg-opt update<br />
...<br />
root@palm-webos-device: # ipkg-opt install squid<br />
Installing squid (2.6.21-2) to root...<br />
Downloading http://ipkg.nslu2-linux.org/feeds/optware/cs08q1armel/cross/unstable/squid_2.6.21-2_arm.ipk<br />
Configuring squid<br />
create default cache and logs dir<br />
chown: unknown user/group nobody:nobody<br />
chown: unknown user/group nobody:nobody<br />
FATAL: Could not determine fully qualified hostname.Please set 'visible_hostname'<br />
<br />
Squid Cache (Version 2.6.STABLE21): Terminated abnormally.<br />
CPU Usage: 0.020 seconds = 0.010 user + 0.010 sys<br />
Maximum Resident Size: 0 KB<br />
Page faults with physical i/o: 0<br />
Segmentation fault<br />
<br />
You should review the configuration file /opt/etc/squid/squid.conf,<br />
make any necessary change, and complete the install by running -<br />
/opt/etc/init.d/S80squid start<br />
<br />
Successfully terminated.<br />
</source><br />
<br />
Ignore the errors for the moment, we'll get to it soon.<br />
<br />
== Create a basic proxy config ==<br />
<br />
Change to the directory '''/opt/etc/squid''' and move the file '''squid.conf''' which is already there to somewhere else. Now create a new squid.conf, which should have the following contents:<br />
<br />
<source lang="text"><br />
visible_hostname localhost<br />
http_port 3128 transparent <br />
hierarchy_stoplist cgi-bin ? <br />
access_log /var/cache/squid/squid.log squid <br />
acl QUERY urlpath_regex cgi-bin \? <br />
cache deny QUERY <br />
<br />
# replace the ip address with the address of your proxy<br />
# replace the port 3128 with the port of your proxy<br />
cache_peer 192.168.2.205 parent 3128 3130 default <br />
<br />
# if your proxy requires authentication, use this:<br />
# cache_peer 192.168.2.205 parent 3128 3130 default login USERNAME PASSWORD<br />
<br />
refresh_pattern ^ftp: 1440 20% 10080<br />
refresh_pattern ^gopher: 1440 0% 1440<br />
refresh_pattern . 0 20% 4320<br />
acl apache rep_header Server ^Apache <br />
broken_vary_encoding allow apache <br />
coredump_dir /var/cache/squid <br />
cache_dir ufs /var/cache/squid 20 5 5<br />
access_log /var/cache/squid/squid.log<br />
cache_log /var/cache/squid/cache.log<br />
cache_store_log /dev/null<br />
<br />
acl all src 0.0.0.0/0.0.0.0<br />
acl manager proto cache_object<br />
acl localhost src 127.0.0.1/255.255.255.255<br />
acl to_localhost dst 127.0.0.0/8<br />
acl SSL_ports port 443<br />
acl Safe_ports port 80 # http<br />
acl Safe_ports port 21 # ftp<br />
acl Safe_ports port 443 # https<br />
acl Safe_ports port 70 # gopher<br />
acl Safe_ports port 210 # wais<br />
acl Safe_ports port 1025-65535 # unregistered ports<br />
acl Safe_ports port 280 # http-mgmt<br />
acl Safe_ports port 488 # gss-http<br />
acl Safe_ports port 591 # filemaker<br />
acl Safe_ports port 777 # multiling http<br />
acl CONNECT method CONNECT<br />
http_access allow manager localhost<br />
http_access deny manager<br />
http_access deny !Safe_ports<br />
http_access deny CONNECT !SSL_ports<br />
# example for an ACL, uncomment and modify<br />
#acl enemy dstdomain www.apple.com<br />
#http_access deny enemy<br />
<br />
http_access allow all<br />
icp_access allow all<br />
<br />
</source><br />
<br />
Basically this is a config for a transparent proxy, thus a browser will be redirected to it without knowing that it is actually connected to a proxy. We must configure it this way because the WebOS browser cannot be configured to use a proxy.<br />
<br />
Note that we have added a single ACL here, which denies access to some random site *g*. Any other requests will be allowed. SSL (HTTPS) will not be passed through the proxy because this requires the browser to connect to it using a proxy request.<br />
<br />
You WILL need to modify the squid.conf variable ''cache_peer'', it points to your upstream proxy, e.g. your companys proxy. Refer to the comments for the syntax.<br />
<br />
== Prepare the directories for squid ==<br />
<br />
Squid needs a directory where to store it's files, as content it caches and logfiles. You may consider to disable caching and logging. But caching may be a good idea if your traffic is limited, so you'll save some. Logging is always usefull for debugging. If you want to turn it off, use '''/dev/null''' as target for the logfiles.<br />
<br />
<source lang="text"><br />
mkdir /var/cache/squid<br />
chown nobody /var/cache/squid<br />
</source><br />
<br />
Next you need let squid to prepare the directory structure using the -z option:<br />
<br />
<source lang="text"><br />
root@palm-webos-device: # squid -z -f squid.conf<br />
2009/11/26 23:19:29| Creating Swap Directories<br />
</source><br />
<br />
You should not see any errors here!<br />
<br />
== Starting squid ==<br />
<br />
The installer already added it to the startup daemons, now we will start it manually:<br />
<br />
<source lang="text"><br />
/opt/etc/init.d/S80squid start<br />
</source><br />
<br />
Look in '''/var/cache/squid/cache.log''' for any errors. Use ps to see if it really runs. You may consider to install '''lynx''' and test the proxy:<br />
<br />
<source lang="text"><br />
ipkg-opt install lynx<br />
export http_proxy=http://localhost:3128<br />
lynx www.google.com<br />
</source><br />
<br />
If you see a google textmode site, it works.<br />
<br />
Turn it off if everything is ok:<br />
<br />
<source lang="text"><br />
/opt/etc/init.d/S80squid stop<br />
</source><br />
<br />
== Add the rules to the squid startup file ==<br />
<br />
Now comes the ugly part. I'll not explain it in detail: we install some iptable Rules. We tell iptables to forward any traffic destined to tcp port 80 to localhost port 3128 (this is where squid listens for incoming connections). To avoid that the requests of the proxy itself are forwarded to localhost (which would create a loop), we add a rule telling iptables to not forward web traffic if it were generated by user nobody (the user squid runs as).<br />
<br />
To do that, edit '''/opt/etc/init.d/S80squid''' so that it looks like this:<br />
<source lang="text"><br />
#! /bin/sh<br />
<br />
case "$1" in<br />
start)<br />
echo -n "Starting proxy server: "<br />
if [ -n "`pidof quotacheck`" ]; then<br />
#you don't need it if you don't have quota check enable.<br />
echo "Starting squid-cache server after delay for few mins:"<br />
/opt/etc/squid/squid.delay-start.sh&amp;<br />
else<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf<br />
iptables -t nat -A OUTPUT -p tcp --dport 80 -m owner --gid-owner 65534 -j ACCEPT<br />
iptables -t nat -A OUTPUT -p tcp --dport 80 -j DNAT --to-destination 127.0.0.1:3128<br />
echo "done."<br />
fi<br />
echo "done."<br />
;;<br />
stop)<br />
echo -n "Stopping proxy server: "<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf -k shutdown<br />
iptables -t nat -D OUTPUT -p tcp --dport 80 -m owner --gid-owner 65534 -j ACCEPT<br />
iptables -t nat -D OUTPUT -p tcp --dport 80 -j DNAT --to-destination 127.0.0.1:3128<br />
echo "done."<br />
;;<br />
reload|force-reload)<br />
echo -n "Reloading proxy server configuration files: "<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf -k reconfigure<br />
echo "done."<br />
;;<br />
restart)<br />
echo -n "Restarting proxy server: "<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf -k shutdown<br />
sleep 2<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf<br />
echo "done."<br />
;;<br />
*)<br />
echo "Usage: /opt/etc/init.d/S80squid {start|stop|reload|force-reload|restart}"<br />
exit 1<br />
;;<br />
esac<br />
</source><br />
<br />
== Configure network to startup squid if WLAN comes up ==<br />
<br />
Now we need to alter the behavior of the palm network manager so that it starts squid if WIFI comes up and stops it when WIFI goes down.<br />
<br />
Change to directory ''/etc/pmnetconfig/''.<br />
<br />
In the file ''if-up'' modify this part:<br />
<source lang="text"<br />
if [ "$ISPPP" -ne 4 ] &amp;&amp; [ "$ISRMNET" -ne 6 ] &amp;&amp; [ "$ISTUN" -ne 4 ] &amp;&amp; [ "$ISCSCOTUNVPN" -ne 8 ]; then<br />
NetCfgSetAddr<br />
CMSERVICES=$((${CMSERVICES} | ${CMSVCINTERNET}))<br />
fi<br />
</source><br />
to<br />
<source lang="text"<br />
if [ "$ISPPP" -ne 4 ] &amp;&amp; [ "$ISRMNET" -ne 6 ] &amp;&amp; [ "$ISTUN" -ne 4 ] &amp;&amp; [ "$ISCSCOTUNVPN" -ne 8 ]; then<br />
NetCfgSetAddr<br />
CMSERVICES=$((${CMSERVICES} | ${CMSVCINTERNET}))<br />
/usr/bin/logger "wifi up: execute /opt/etc/init.d/S80squid start" <br />
/opt/etc/init.d/S80squid start<br />
fi<br />
</source><br />
In the file ''if-down'' modify this part:<br />
<source lang="text"<br />
if [ ${CMINTERFACE} = ${CMBTINTERFACENAME} ] || [ ${CMINTERFACE} = ${CMBRINTERFACENAME} ]; then<br />
${LOG} "${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE"<br />
${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE<br />
${LOG} "${ECHO} 0 >/proc/sys/net/ipv4/ip_forward"<br />
${ECHO} 0 >/proc/sys/net/ipv4/ip_forward<br />
fi <br />
</source><br />
to:<br />
<source lang="text"<br />
if [ ${CMINTERFACE} = ${CMBTINTERFACENAME} ] || [ ${CMINTERFACE} = ${CMBRINTERFACENAME} ]; then<br />
${LOG} "${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE"<br />
${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE<br />
${LOG} "${ECHO} 0 >/proc/sys/net/ipv4/ip_forward"<br />
${ECHO} 0 >/proc/sys/net/ipv4/ip_forward<br />
/usr/bin/logger "wifi up: execute /opt/etc/init.d/S80squid stop" <br />
/opt/etc/init.d/S80squid stop <br />
fi <br />
</source><br />
<br />
<br />
== See it working ==<br />
<br />
So, let's see how it works. Enable WIFI and fire up the browser and see if it works. You should see your requests on the remote proxy.<br />
<br />
If you added an ACL as mentioned earlier, a message like the following should appear if you enter the url of your favourite enemy vendor (the one we configured above):<br />
<br />
[[Image:Squid-access-denied-palm-pre.png]]<br />
<br />
== Blocking Adverts ==<br />
<br />
Now squid is set up, we can use it for ad blocking. There are two steps to this:<br />
<br />
=== Obtain a block list ===<br />
<br />
An excellent ad block list is maintained at [http://pgl.yoyo.org/as/]. We need to download it in a suitable format for squid, which can be done by running the following command:<br />
<br />
<source lang="text"><br />
wget -q -O - 'http://pgl.yoyo.org/as/serverlist.php?hostformat=squid-dstdom-regex;showintro=0' | grep -v ">" | grep "." > /opt/etc/squid/blocklist<br />
</source><br />
<br />
(Technical details: the wget command downloads the URL given in single quotes, then we strip the HTML mark-up and blank lines using grep. The filename at the end is where the black list will be stored.)<br />
<br />
=== Configure squid to use the block list ===<br />
<br />
Now we need to tell squid to block the list of URLs in the file we've just created. Open the ''/opt/etc/squid/squid.conf'' file we created above, and scroll down to where it reads:<br />
<br />
<source lang="text"><br />
acl enemy dstdomain www.apple.com<br />
</source><br />
<br />
Replace this line with:<br />
<br />
<source lang="text"><br />
acl enemy dstdom_regex "/opt/etc/squid/blocklist"<br />
</source><br />
<br />
Finally, restart squid:<br />
<br />
<source lang="text"><br />
/opt/etc/init.d/S80squid restart<br />
</source><br />
<br />
To test it's working, open a browser and try to visit ''ads.msn.com'' (one of the blocked URLs). The error given should be similar to the screenshot given above.<br />
<br />
If in the future you need to update the ad blocking list, run the commands:<br />
<br />
<source lang="text"><br />
cd / && mount -v -o remount,rw /<br />
wget -q -O - 'http://pgl.yoyo.org/as/serverlist.php?hostformat=squid-dstdom-regex;showintro=0' | grep -v ">" | grep "." > /opt/etc/squid/blocklist<br />
/opt/etc/init.d/S80squid restart<br />
</source><br />
<br />
For further details of filtering URLs using squid, please refer to the [http://www.squid-cache.org/Doc/ excelent documentation of the squid cache project].</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=SetupSquidTransparentProxy&diff=9091SetupSquidTransparentProxy2010-02-17T18:34:09Z<p>Debilater: /* Starting squid */</p>
<hr />
<div>= Squid Transparent Proxy on Palm Pre =<br />
<br />
Ok, someone asked for it, so I figured it out, how to do it for fun and profit:<br />
<br />
== Preparation ==<br />
<br />
First, you need to have root access to your device. How to get root, is described [[Next_steps|here]]. It would be a good idea to know a little about linux and networking too. '''Be warned: this can make your networking unfunctional!'''<br />
<br />
Next thing you need to do is to install the package '''Optware Advanced Linux Command Line Installer''' from Preware, which installs '''ipkg-opt'''!<br />
<br />
== Installing Squid ==<br />
<br />
Login to the pre console and make your root disk writable:<br />
<br />
<source lang="text"><br />
root@palm-webos-device: # cd / && mount -v -o remount,rw /<br />
</source><br />
<br />
Type this command to install the squid optware package<br />
<br />
<source lang="text"><br />
root@palm-webos-device: # ipkg-opt update<br />
...<br />
root@palm-webos-device: # ipkg-opt install squid<br />
Installing squid (2.6.21-2) to root...<br />
Downloading http://ipkg.nslu2-linux.org/feeds/optware/cs08q1armel/cross/unstable/squid_2.6.21-2_arm.ipk<br />
Configuring squid<br />
create default cache and logs dir<br />
chown: unknown user/group nobody:nobody<br />
chown: unknown user/group nobody:nobody<br />
FATAL: Could not determine fully qualified hostname.Please set 'visible_hostname'<br />
<br />
Squid Cache (Version 2.6.STABLE21): Terminated abnormally.<br />
CPU Usage: 0.020 seconds = 0.010 user + 0.010 sys<br />
Maximum Resident Size: 0 KB<br />
Page faults with physical i/o: 0<br />
Segmentation fault<br />
<br />
You should review the configuration file /opt/etc/squid/squid.conf,<br />
make any necessary change, and complete the install by running -<br />
/opt/etc/init.d/S80squid start<br />
<br />
Successfully terminated.<br />
</source><br />
<br />
Ignore the errors for the moment, we'll get to it soon.<br />
<br />
== Create a basic proxy config ==<br />
<br />
Change to the directory '''/opt/etc/squid''' and move the file '''squid.conf''' which is already there to somewhere else. Now create a new squid.conf, which should have the following contents:<br />
<br />
<source lang="text"><br />
visible_hostname localhost<br />
http_port 3128 transparent <br />
hierarchy_stoplist cgi-bin ? <br />
access_log /var/cache/squid/squid.log squid <br />
acl QUERY urlpath_regex cgi-bin \? <br />
cache deny QUERY <br />
<br />
# replace the ip address with the address of your proxy<br />
# replace the port 3128 with the port of your proxy<br />
cache_peer 192.168.2.205 parent 3128 3130 default <br />
<br />
# if your proxy requires authentication, use this:<br />
# cache_peer 192.168.2.205 parent 3128 3130 default login USERNAME PASSWORD<br />
<br />
refresh_pattern ^ftp: 1440 20% 10080<br />
refresh_pattern ^gopher: 1440 0% 1440<br />
refresh_pattern . 0 20% 4320<br />
acl apache rep_header Server ^Apache <br />
broken_vary_encoding allow apache <br />
coredump_dir /var/cache/squid <br />
cache_dir ufs /var/cache/squid 20 5 5<br />
access_log /var/cache/squid/squid.log<br />
cache_log /var/cache/squid/cache.log<br />
cache_store_log /dev/null<br />
<br />
acl all src 0.0.0.0/0.0.0.0<br />
acl manager proto cache_object<br />
acl localhost src 127.0.0.1/255.255.255.255<br />
acl to_localhost dst 127.0.0.0/8<br />
acl SSL_ports port 443<br />
acl Safe_ports port 80 # http<br />
acl Safe_ports port 21 # ftp<br />
acl Safe_ports port 443 # https<br />
acl Safe_ports port 70 # gopher<br />
acl Safe_ports port 210 # wais<br />
acl Safe_ports port 1025-65535 # unregistered ports<br />
acl Safe_ports port 280 # http-mgmt<br />
acl Safe_ports port 488 # gss-http<br />
acl Safe_ports port 591 # filemaker<br />
acl Safe_ports port 777 # multiling http<br />
acl CONNECT method CONNECT<br />
http_access allow manager localhost<br />
http_access deny manager<br />
http_access deny !Safe_ports<br />
http_access deny CONNECT !SSL_ports<br />
# example for an ACL, uncomment and modify<br />
#acl enemy dstdomain www.apple.com<br />
#http_access deny enemy<br />
<br />
http_access allow all<br />
icp_access allow all<br />
<br />
</source><br />
<br />
Basically this is a config for a transparent proxy, thus a browser will be redirected to it without knowing that it is actually connected to a proxy. We must configure it this way because the WebOS browser cannot be configured to use a proxy.<br />
<br />
Note that we have added a single ACL here, which denies access to some random site *g*. Any other requests will be allowed. SSL (HTTPS) will not be passed through the proxy because this requires the browser to connect to it using a proxy request.<br />
<br />
You WILL need to modify the squid.conf variable ''cache_peer'', it points to your upstream proxy, e.g. your companys proxy. Refer to the comments for the syntax.<br />
<br />
== Prepare the directories for squid ==<br />
<br />
Squid needs a directory where to store it's files, as content it caches and logfiles. You may consider to disable caching and logging. But caching may be a good idea if your traffic is limited, so you'll save some. Logging is always usefull for debugging. If you want to turn it off, use '''/dev/null''' as target for the logfiles.<br />
<br />
<source lang="text"><br />
mkdir /var/cache/squid<br />
chown nobody /var/cache/squid<br />
</source><br />
<br />
Next you need let squid to prepare the directory structure using the -z option:<br />
<br />
<source lang="text"><br />
root@palm-webos-device: # squid -z -f squid.conf<br />
2009/11/26 23:19:29| Creating Swap Directories<br />
</source><br />
<br />
You should not see any errors here!<br />
<br />
== Starting squid ==<br />
<br />
The installer already added it to the startup daemons, now we will start it manually:<br />
<br />
<source lang="text"><br />
/opt/etc/init.d/S80squid start<br />
</source><br />
<br />
Look in '''/var/cache/squid/cache.log''' for any errors. Use ps to see if it really runs. You may consider to install '''lynx''' and test the proxy:<br />
<br />
<source lang="text"><br />
ipkg-opt install lynx<br />
export http_proxy=http://localhost:3128<br />
lynx www.google.com<br />
</source><br />
<br />
If you see a google textmode site, it works.<br />
<br />
Turn it off if everything is ok:<br />
<br />
<source lang="text"><br />
/opt/etc/init.d/S80squid stop<br />
</source><br />
<br />
== Add the rules to the squid startup file ==<br />
<br />
Now comes the ugly part. I'll not explain it in detail: we install some iptable Rules. We tell iptables to forward any traffic destined to tcp port 80 to localhost port 3128 (this is where squid listens for incoming connections). To avoid that the requests of the proxy itself are forwarded to localhost (which would create a loop), we add a rule telling iptables to not forward web traffic if it were generated by user nobody (the user squid runs as).<br />
<br />
To do that, edit B</opt/etc/init.d/S80squid> so that it looks like this:<br />
<source lang="text"><br />
#! /bin/sh<br />
<br />
case "$1" in<br />
start)<br />
echo -n "Starting proxy server: "<br />
if [ -n "`pidof quotacheck`" ]; then<br />
#you don't need it if you don't have quota check enable.<br />
echo "Starting squid-cache server after delay for few mins:"<br />
/opt/etc/squid/squid.delay-start.sh&amp;<br />
else<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf<br />
iptables -t nat -A OUTPUT -p tcp --dport 80 -m owner --gid-owner 65534 -j ACCEPT<br />
iptables -t nat -A OUTPUT -p tcp --dport 80 -j DNAT --to-destination 127.0.0.1:3128<br />
echo "done."<br />
fi<br />
echo "done."<br />
;;<br />
stop)<br />
echo -n "Stopping proxy server: "<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf -k shutdown<br />
iptables -t nat -D OUTPUT -p tcp --dport 80 -m owner --gid-owner 65534 -j ACCEPT<br />
iptables -t nat -D OUTPUT -p tcp --dport 80 -j DNAT --to-destination 127.0.0.1:3128<br />
echo "done."<br />
;;<br />
reload|force-reload)<br />
echo -n "Reloading proxy server configuration files: "<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf -k reconfigure<br />
echo "done."<br />
;;<br />
restart)<br />
echo -n "Restarting proxy server: "<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf -k shutdown<br />
sleep 2<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf<br />
echo "done."<br />
;;<br />
*)<br />
echo "Usage: /opt/etc/init.d/S80squid {start|stop|reload|force-reload|restart}"<br />
exit 1<br />
;;<br />
esac<br />
</source><br />
<br />
== Configure network to startup squid if WLAN comes up ==<br />
<br />
Now we need to alter the behavior of the palm network manager so that it starts squid if WIFI comes up and stops it when WIFI goes down.<br />
<br />
Change to directory ''/etc/pmnetconfig/''.<br />
<br />
In the file ''if-up'' modify this part:<br />
<source lang="text"<br />
if [ "$ISPPP" -ne 4 ] &amp;&amp; [ "$ISRMNET" -ne 6 ] &amp;&amp; [ "$ISTUN" -ne 4 ] &amp;&amp; [ "$ISCSCOTUNVPN" -ne 8 ]; then<br />
NetCfgSetAddr<br />
CMSERVICES=$((${CMSERVICES} | ${CMSVCINTERNET}))<br />
fi<br />
</source><br />
to<br />
<source lang="text"<br />
if [ "$ISPPP" -ne 4 ] &amp;&amp; [ "$ISRMNET" -ne 6 ] &amp;&amp; [ "$ISTUN" -ne 4 ] &amp;&amp; [ "$ISCSCOTUNVPN" -ne 8 ]; then<br />
NetCfgSetAddr<br />
CMSERVICES=$((${CMSERVICES} | ${CMSVCINTERNET}))<br />
/usr/bin/logger "wifi up: execute /opt/etc/init.d/S80squid start" <br />
/opt/etc/init.d/S80squid start<br />
fi<br />
</source><br />
In the file ''if-down'' modify this part:<br />
<source lang="text"<br />
if [ ${CMINTERFACE} = ${CMBTINTERFACENAME} ] || [ ${CMINTERFACE} = ${CMBRINTERFACENAME} ]; then<br />
${LOG} "${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE"<br />
${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE<br />
${LOG} "${ECHO} 0 >/proc/sys/net/ipv4/ip_forward"<br />
${ECHO} 0 >/proc/sys/net/ipv4/ip_forward<br />
fi <br />
</source><br />
to:<br />
<source lang="text"<br />
if [ ${CMINTERFACE} = ${CMBTINTERFACENAME} ] || [ ${CMINTERFACE} = ${CMBRINTERFACENAME} ]; then<br />
${LOG} "${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE"<br />
${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE<br />
${LOG} "${ECHO} 0 >/proc/sys/net/ipv4/ip_forward"<br />
${ECHO} 0 >/proc/sys/net/ipv4/ip_forward<br />
/usr/bin/logger "wifi up: execute /opt/etc/init.d/S80squid stop" <br />
/opt/etc/init.d/S80squid stop <br />
fi <br />
</source><br />
<br />
<br />
== See it working ==<br />
<br />
So, let's see how it works. Enable WIFI and fire up the browser and see if it works. You should see your requests on the remote proxy.<br />
<br />
If you added an ACL as mentioned earlier, a message like the following should appear if you enter the url of your favourite enemy vendor (the one we configured above):<br />
<br />
[[Image:Squid-access-denied-palm-pre.png]]<br />
<br />
== Blocking Adverts ==<br />
<br />
Now squid is set up, we can use it for ad blocking. There are two steps to this:<br />
<br />
=== Obtain a block list ===<br />
<br />
An excellent ad block list is maintained at [http://pgl.yoyo.org/as/]. We need to download it in a suitable format for squid, which can be done by running the following command:<br />
<br />
<source lang="text"><br />
wget -q -O - 'http://pgl.yoyo.org/as/serverlist.php?hostformat=squid-dstdom-regex;showintro=0' | grep -v ">" | grep "." > /opt/etc/squid/blocklist<br />
</source><br />
<br />
(Technical details: the wget command downloads the URL given in single quotes, then we strip the HTML mark-up and blank lines using grep. The filename at the end is where the black list will be stored.)<br />
<br />
=== Configure squid to use the block list ===<br />
<br />
Now we need to tell squid to block the list of URLs in the file we've just created. Open the ''/opt/etc/squid/squid.conf'' file we created above, and scroll down to where it reads:<br />
<br />
<source lang="text"><br />
acl enemy dstdomain www.apple.com<br />
</source><br />
<br />
Replace this line with:<br />
<br />
<source lang="text"><br />
acl enemy dstdom_regex "/opt/etc/squid/blocklist"<br />
</source><br />
<br />
Finally, restart squid:<br />
<br />
<source lang="text"><br />
/opt/etc/init.d/S80squid restart<br />
</source><br />
<br />
To test it's working, open a browser and try to visit ''ads.msn.com'' (one of the blocked URLs). The error given should be similar to the screenshot given above.<br />
<br />
If in the future you need to update the ad blocking list, run the commands:<br />
<br />
<source lang="text"><br />
cd / && mount -v -o remount,rw /<br />
wget -q -O - 'http://pgl.yoyo.org/as/serverlist.php?hostformat=squid-dstdom-regex;showintro=0' | grep -v ">" | grep "." > /opt/etc/squid/blocklist<br />
/opt/etc/init.d/S80squid restart<br />
</source><br />
<br />
For further details of filtering URLs using squid, please refer to the [http://www.squid-cache.org/Doc/ excelent documentation of the squid cache project].</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=SetupSquidTransparentProxy&diff=9090SetupSquidTransparentProxy2010-02-17T18:31:07Z<p>Debilater: /* Installing Squid */</p>
<hr />
<div>= Squid Transparent Proxy on Palm Pre =<br />
<br />
Ok, someone asked for it, so I figured it out, how to do it for fun and profit:<br />
<br />
== Preparation ==<br />
<br />
First, you need to have root access to your device. How to get root, is described [[Next_steps|here]]. It would be a good idea to know a little about linux and networking too. '''Be warned: this can make your networking unfunctional!'''<br />
<br />
Next thing you need to do is to install the package '''Optware Advanced Linux Command Line Installer''' from Preware, which installs '''ipkg-opt'''!<br />
<br />
== Installing Squid ==<br />
<br />
Login to the pre console and make your root disk writable:<br />
<br />
<source lang="text"><br />
root@palm-webos-device: # cd / && mount -v -o remount,rw /<br />
</source><br />
<br />
Type this command to install the squid optware package<br />
<br />
<source lang="text"><br />
root@palm-webos-device: # ipkg-opt update<br />
...<br />
root@palm-webos-device: # ipkg-opt install squid<br />
Installing squid (2.6.21-2) to root...<br />
Downloading http://ipkg.nslu2-linux.org/feeds/optware/cs08q1armel/cross/unstable/squid_2.6.21-2_arm.ipk<br />
Configuring squid<br />
create default cache and logs dir<br />
chown: unknown user/group nobody:nobody<br />
chown: unknown user/group nobody:nobody<br />
FATAL: Could not determine fully qualified hostname.Please set 'visible_hostname'<br />
<br />
Squid Cache (Version 2.6.STABLE21): Terminated abnormally.<br />
CPU Usage: 0.020 seconds = 0.010 user + 0.010 sys<br />
Maximum Resident Size: 0 KB<br />
Page faults with physical i/o: 0<br />
Segmentation fault<br />
<br />
You should review the configuration file /opt/etc/squid/squid.conf,<br />
make any necessary change, and complete the install by running -<br />
/opt/etc/init.d/S80squid start<br />
<br />
Successfully terminated.<br />
</source><br />
<br />
Ignore the errors for the moment, we'll get to it soon.<br />
<br />
== Create a basic proxy config ==<br />
<br />
Change to the directory '''/opt/etc/squid''' and move the file '''squid.conf''' which is already there to somewhere else. Now create a new squid.conf, which should have the following contents:<br />
<br />
<source lang="text"><br />
visible_hostname localhost<br />
http_port 3128 transparent <br />
hierarchy_stoplist cgi-bin ? <br />
access_log /var/cache/squid/squid.log squid <br />
acl QUERY urlpath_regex cgi-bin \? <br />
cache deny QUERY <br />
<br />
# replace the ip address with the address of your proxy<br />
# replace the port 3128 with the port of your proxy<br />
cache_peer 192.168.2.205 parent 3128 3130 default <br />
<br />
# if your proxy requires authentication, use this:<br />
# cache_peer 192.168.2.205 parent 3128 3130 default login USERNAME PASSWORD<br />
<br />
refresh_pattern ^ftp: 1440 20% 10080<br />
refresh_pattern ^gopher: 1440 0% 1440<br />
refresh_pattern . 0 20% 4320<br />
acl apache rep_header Server ^Apache <br />
broken_vary_encoding allow apache <br />
coredump_dir /var/cache/squid <br />
cache_dir ufs /var/cache/squid 20 5 5<br />
access_log /var/cache/squid/squid.log<br />
cache_log /var/cache/squid/cache.log<br />
cache_store_log /dev/null<br />
<br />
acl all src 0.0.0.0/0.0.0.0<br />
acl manager proto cache_object<br />
acl localhost src 127.0.0.1/255.255.255.255<br />
acl to_localhost dst 127.0.0.0/8<br />
acl SSL_ports port 443<br />
acl Safe_ports port 80 # http<br />
acl Safe_ports port 21 # ftp<br />
acl Safe_ports port 443 # https<br />
acl Safe_ports port 70 # gopher<br />
acl Safe_ports port 210 # wais<br />
acl Safe_ports port 1025-65535 # unregistered ports<br />
acl Safe_ports port 280 # http-mgmt<br />
acl Safe_ports port 488 # gss-http<br />
acl Safe_ports port 591 # filemaker<br />
acl Safe_ports port 777 # multiling http<br />
acl CONNECT method CONNECT<br />
http_access allow manager localhost<br />
http_access deny manager<br />
http_access deny !Safe_ports<br />
http_access deny CONNECT !SSL_ports<br />
# example for an ACL, uncomment and modify<br />
#acl enemy dstdomain www.apple.com<br />
#http_access deny enemy<br />
<br />
http_access allow all<br />
icp_access allow all<br />
<br />
</source><br />
<br />
Basically this is a config for a transparent proxy, thus a browser will be redirected to it without knowing that it is actually connected to a proxy. We must configure it this way because the WebOS browser cannot be configured to use a proxy.<br />
<br />
Note that we have added a single ACL here, which denies access to some random site *g*. Any other requests will be allowed. SSL (HTTPS) will not be passed through the proxy because this requires the browser to connect to it using a proxy request.<br />
<br />
You WILL need to modify the squid.conf variable ''cache_peer'', it points to your upstream proxy, e.g. your companys proxy. Refer to the comments for the syntax.<br />
<br />
== Prepare the directories for squid ==<br />
<br />
Squid needs a directory where to store it's files, as content it caches and logfiles. You may consider to disable caching and logging. But caching may be a good idea if your traffic is limited, so you'll save some. Logging is always usefull for debugging. If you want to turn it off, use '''/dev/null''' as target for the logfiles.<br />
<br />
<source lang="text"><br />
mkdir /var/cache/squid<br />
chown nobody /var/cache/squid<br />
</source><br />
<br />
Next you need let squid to prepare the directory structure using the -z option:<br />
<br />
<source lang="text"><br />
root@palm-webos-device: # squid -z -f squid.conf<br />
2009/11/26 23:19:29| Creating Swap Directories<br />
</source><br />
<br />
You should not see any errors here!<br />
<br />
== Starting squid ==<br />
<br />
The installer already added it to the startup daemons, now we will start it manually:<br />
<br />
<source lang="text"><br />
/opt/etc/init.d/S80squid start<br />
</source><br />
<br />
Look in '''/var/cache/squid/cache.log''' for any errors. Use ps to see if it really runs. You may consider to install '''lynx''' and test the proxy:<br />
<br />
<source lang="text"><br />
ipkg-opt install lynx<br />
export http_proxy=http://localhost:3128<br />
lynx www.google.com<br />
</source><br />
<br />
If you see a google textmode site, it works.<br />
<br />
== Add the rules to the squid startup file ==<br />
<br />
Now comes the ugly part. I'll not explain it in detail: we install some iptable Rules. We tell iptables to forward any traffic destined to tcp port 80 to localhost port 3128 (this is where squid listens for incoming connections). To avoid that the requests of the proxy itself are forwarded to localhost (which would create a loop), we add a rule telling iptables to not forward web traffic if it were generated by user nobody (the user squid runs as).<br />
<br />
To do that, edit B</opt/etc/init.d/S80squid> so that it looks like this:<br />
<source lang="text"><br />
#! /bin/sh<br />
<br />
case "$1" in<br />
start)<br />
echo -n "Starting proxy server: "<br />
if [ -n "`pidof quotacheck`" ]; then<br />
#you don't need it if you don't have quota check enable.<br />
echo "Starting squid-cache server after delay for few mins:"<br />
/opt/etc/squid/squid.delay-start.sh&amp;<br />
else<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf<br />
iptables -t nat -A OUTPUT -p tcp --dport 80 -m owner --gid-owner 65534 -j ACCEPT<br />
iptables -t nat -A OUTPUT -p tcp --dport 80 -j DNAT --to-destination 127.0.0.1:3128<br />
echo "done."<br />
fi<br />
echo "done."<br />
;;<br />
stop)<br />
echo -n "Stopping proxy server: "<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf -k shutdown<br />
iptables -t nat -D OUTPUT -p tcp --dport 80 -m owner --gid-owner 65534 -j ACCEPT<br />
iptables -t nat -D OUTPUT -p tcp --dport 80 -j DNAT --to-destination 127.0.0.1:3128<br />
echo "done."<br />
;;<br />
reload|force-reload)<br />
echo -n "Reloading proxy server configuration files: "<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf -k reconfigure<br />
echo "done."<br />
;;<br />
restart)<br />
echo -n "Restarting proxy server: "<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf -k shutdown<br />
sleep 2<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf<br />
echo "done."<br />
;;<br />
*)<br />
echo "Usage: /opt/etc/init.d/S80squid {start|stop|reload|force-reload|restart}"<br />
exit 1<br />
;;<br />
esac<br />
</source><br />
<br />
== Configure network to startup squid if WLAN comes up ==<br />
<br />
Now we need to alter the behavior of the palm network manager so that it starts squid if WIFI comes up and stops it when WIFI goes down.<br />
<br />
Change to directory ''/etc/pmnetconfig/''.<br />
<br />
In the file ''if-up'' modify this part:<br />
<source lang="text"<br />
if [ "$ISPPP" -ne 4 ] &amp;&amp; [ "$ISRMNET" -ne 6 ] &amp;&amp; [ "$ISTUN" -ne 4 ] &amp;&amp; [ "$ISCSCOTUNVPN" -ne 8 ]; then<br />
NetCfgSetAddr<br />
CMSERVICES=$((${CMSERVICES} | ${CMSVCINTERNET}))<br />
fi<br />
</source><br />
to<br />
<source lang="text"<br />
if [ "$ISPPP" -ne 4 ] &amp;&amp; [ "$ISRMNET" -ne 6 ] &amp;&amp; [ "$ISTUN" -ne 4 ] &amp;&amp; [ "$ISCSCOTUNVPN" -ne 8 ]; then<br />
NetCfgSetAddr<br />
CMSERVICES=$((${CMSERVICES} | ${CMSVCINTERNET}))<br />
/usr/bin/logger "wifi up: execute /opt/etc/init.d/S80squid start" <br />
/opt/etc/init.d/S80squid start<br />
fi<br />
</source><br />
In the file ''if-down'' modify this part:<br />
<source lang="text"<br />
if [ ${CMINTERFACE} = ${CMBTINTERFACENAME} ] || [ ${CMINTERFACE} = ${CMBRINTERFACENAME} ]; then<br />
${LOG} "${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE"<br />
${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE<br />
${LOG} "${ECHO} 0 >/proc/sys/net/ipv4/ip_forward"<br />
${ECHO} 0 >/proc/sys/net/ipv4/ip_forward<br />
fi <br />
</source><br />
to:<br />
<source lang="text"<br />
if [ ${CMINTERFACE} = ${CMBTINTERFACENAME} ] || [ ${CMINTERFACE} = ${CMBRINTERFACENAME} ]; then<br />
${LOG} "${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE"<br />
${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE<br />
${LOG} "${ECHO} 0 >/proc/sys/net/ipv4/ip_forward"<br />
${ECHO} 0 >/proc/sys/net/ipv4/ip_forward<br />
/usr/bin/logger "wifi up: execute /opt/etc/init.d/S80squid stop" <br />
/opt/etc/init.d/S80squid stop <br />
fi <br />
</source><br />
<br />
<br />
== See it working ==<br />
<br />
So, let's see how it works. Enable WIFI and fire up the browser and see if it works. You should see your requests on the remote proxy.<br />
<br />
If you added an ACL as mentioned earlier, a message like the following should appear if you enter the url of your favourite enemy vendor (the one we configured above):<br />
<br />
[[Image:Squid-access-denied-palm-pre.png]]<br />
<br />
== Blocking Adverts ==<br />
<br />
Now squid is set up, we can use it for ad blocking. There are two steps to this:<br />
<br />
=== Obtain a block list ===<br />
<br />
An excellent ad block list is maintained at [http://pgl.yoyo.org/as/]. We need to download it in a suitable format for squid, which can be done by running the following command:<br />
<br />
<source lang="text"><br />
wget -q -O - 'http://pgl.yoyo.org/as/serverlist.php?hostformat=squid-dstdom-regex;showintro=0' | grep -v ">" | grep "." > /opt/etc/squid/blocklist<br />
</source><br />
<br />
(Technical details: the wget command downloads the URL given in single quotes, then we strip the HTML mark-up and blank lines using grep. The filename at the end is where the black list will be stored.)<br />
<br />
=== Configure squid to use the block list ===<br />
<br />
Now we need to tell squid to block the list of URLs in the file we've just created. Open the ''/opt/etc/squid/squid.conf'' file we created above, and scroll down to where it reads:<br />
<br />
<source lang="text"><br />
acl enemy dstdomain www.apple.com<br />
</source><br />
<br />
Replace this line with:<br />
<br />
<source lang="text"><br />
acl enemy dstdom_regex "/opt/etc/squid/blocklist"<br />
</source><br />
<br />
Finally, restart squid:<br />
<br />
<source lang="text"><br />
/opt/etc/init.d/S80squid restart<br />
</source><br />
<br />
To test it's working, open a browser and try to visit ''ads.msn.com'' (one of the blocked URLs). The error given should be similar to the screenshot given above.<br />
<br />
If in the future you need to update the ad blocking list, run the commands:<br />
<br />
<source lang="text"><br />
cd / && mount -v -o remount,rw /<br />
wget -q -O - 'http://pgl.yoyo.org/as/serverlist.php?hostformat=squid-dstdom-regex;showintro=0' | grep -v ">" | grep "." > /opt/etc/squid/blocklist<br />
/opt/etc/init.d/S80squid restart<br />
</source><br />
<br />
For further details of filtering URLs using squid, please refer to the [http://www.squid-cache.org/Doc/ excelent documentation of the squid cache project].</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=SetupSquidTransparentProxy&diff=9089SetupSquidTransparentProxy2010-02-17T18:27:12Z<p>Debilater: </p>
<hr />
<div>= Squid Transparent Proxy on Palm Pre =<br />
<br />
Ok, someone asked for it, so I figured it out, how to do it for fun and profit:<br />
<br />
== Preparation ==<br />
<br />
First, you need to have root access to your device. How to get root, is described [[Next_steps|here]]. It would be a good idea to know a little about linux and networking too. '''Be warned: this can make your networking unfunctional!'''<br />
<br />
Next thing you need to do is to install the package '''Optware Advanced Linux Command Line Installer''' from Preware, which installs '''ipkg-opt'''!<br />
<br />
== Installing Squid ==<br />
<br />
Make your root disk writable:<br />
<br />
<source lang="text"><br />
cd / && mount -v -o remount,rw /<br />
</source><br />
<br />
Login to the pre console and type this command to install the squid optware package<br />
<br />
<source lang="text"><br />
root@palm-webos-device: # ipkg-opt update<br />
...<br />
root@palm-webos-device: # ipkg-opt install squid<br />
Installing squid (2.6.21-2) to root...<br />
Downloading http://ipkg.nslu2-linux.org/feeds/optware/cs08q1armel/cross/unstable/squid_2.6.21-2_arm.ipk<br />
Configuring squid<br />
create default cache and logs dir<br />
chown: unknown user/group nobody:nobody<br />
chown: unknown user/group nobody:nobody<br />
FATAL: Could not determine fully qualified hostname.Please set 'visible_hostname'<br />
<br />
Squid Cache (Version 2.6.STABLE21): Terminated abnormally.<br />
CPU Usage: 0.020 seconds = 0.010 user + 0.010 sys<br />
Maximum Resident Size: 0 KB<br />
Page faults with physical i/o: 0<br />
Segmentation fault<br />
<br />
You should review the configuration file /opt/etc/squid/squid.conf,<br />
make any necessary change, and complete the install by running -<br />
/opt/etc/init.d/S80squid start<br />
<br />
Successfully terminated.<br />
</source><br />
<br />
Ignore the errors for the moment, we'll get to it soon.<br />
<br />
== Create a basic proxy config ==<br />
<br />
Change to the directory '''/opt/etc/squid''' and move the file '''squid.conf''' which is already there to somewhere else. Now create a new squid.conf, which should have the following contents:<br />
<br />
<source lang="text"><br />
visible_hostname localhost<br />
http_port 3128 transparent <br />
hierarchy_stoplist cgi-bin ? <br />
access_log /var/cache/squid/squid.log squid <br />
acl QUERY urlpath_regex cgi-bin \? <br />
cache deny QUERY <br />
<br />
# replace the ip address with the address of your proxy<br />
# replace the port 3128 with the port of your proxy<br />
cache_peer 192.168.2.205 parent 3128 3130 default <br />
<br />
# if your proxy requires authentication, use this:<br />
# cache_peer 192.168.2.205 parent 3128 3130 default login USERNAME PASSWORD<br />
<br />
refresh_pattern ^ftp: 1440 20% 10080<br />
refresh_pattern ^gopher: 1440 0% 1440<br />
refresh_pattern . 0 20% 4320<br />
acl apache rep_header Server ^Apache <br />
broken_vary_encoding allow apache <br />
coredump_dir /var/cache/squid <br />
cache_dir ufs /var/cache/squid 20 5 5<br />
access_log /var/cache/squid/squid.log<br />
cache_log /var/cache/squid/cache.log<br />
cache_store_log /dev/null<br />
<br />
acl all src 0.0.0.0/0.0.0.0<br />
acl manager proto cache_object<br />
acl localhost src 127.0.0.1/255.255.255.255<br />
acl to_localhost dst 127.0.0.0/8<br />
acl SSL_ports port 443<br />
acl Safe_ports port 80 # http<br />
acl Safe_ports port 21 # ftp<br />
acl Safe_ports port 443 # https<br />
acl Safe_ports port 70 # gopher<br />
acl Safe_ports port 210 # wais<br />
acl Safe_ports port 1025-65535 # unregistered ports<br />
acl Safe_ports port 280 # http-mgmt<br />
acl Safe_ports port 488 # gss-http<br />
acl Safe_ports port 591 # filemaker<br />
acl Safe_ports port 777 # multiling http<br />
acl CONNECT method CONNECT<br />
http_access allow manager localhost<br />
http_access deny manager<br />
http_access deny !Safe_ports<br />
http_access deny CONNECT !SSL_ports<br />
# example for an ACL, uncomment and modify<br />
#acl enemy dstdomain www.apple.com<br />
#http_access deny enemy<br />
<br />
http_access allow all<br />
icp_access allow all<br />
<br />
</source><br />
<br />
Basically this is a config for a transparent proxy, thus a browser will be redirected to it without knowing that it is actually connected to a proxy. We must configure it this way because the WebOS browser cannot be configured to use a proxy.<br />
<br />
Note that we have added a single ACL here, which denies access to some random site *g*. Any other requests will be allowed. SSL (HTTPS) will not be passed through the proxy because this requires the browser to connect to it using a proxy request.<br />
<br />
You WILL need to modify the squid.conf variable ''cache_peer'', it points to your upstream proxy, e.g. your companys proxy. Refer to the comments for the syntax.<br />
<br />
== Prepare the directories for squid ==<br />
<br />
Squid needs a directory where to store it's files, as content it caches and logfiles. You may consider to disable caching and logging. But caching may be a good idea if your traffic is limited, so you'll save some. Logging is always usefull for debugging. If you want to turn it off, use '''/dev/null''' as target for the logfiles.<br />
<br />
<source lang="text"><br />
mkdir /var/cache/squid<br />
chown nobody /var/cache/squid<br />
</source><br />
<br />
Next you need let squid to prepare the directory structure using the -z option:<br />
<br />
<source lang="text"><br />
root@palm-webos-device: # squid -z -f squid.conf<br />
2009/11/26 23:19:29| Creating Swap Directories<br />
</source><br />
<br />
You should not see any errors here!<br />
<br />
== Starting squid ==<br />
<br />
The installer already added it to the startup daemons, now we will start it manually:<br />
<br />
<source lang="text"><br />
/opt/etc/init.d/S80squid start<br />
</source><br />
<br />
Look in '''/var/cache/squid/cache.log''' for any errors. Use ps to see if it really runs. You may consider to install '''lynx''' and test the proxy:<br />
<br />
<source lang="text"><br />
ipkg-opt install lynx<br />
export http_proxy=http://localhost:3128<br />
lynx www.google.com<br />
</source><br />
<br />
If you see a google textmode site, it works.<br />
<br />
== Add the rules to the squid startup file ==<br />
<br />
Now comes the ugly part. I'll not explain it in detail: we install some iptable Rules. We tell iptables to forward any traffic destined to tcp port 80 to localhost port 3128 (this is where squid listens for incoming connections). To avoid that the requests of the proxy itself are forwarded to localhost (which would create a loop), we add a rule telling iptables to not forward web traffic if it were generated by user nobody (the user squid runs as).<br />
<br />
To do that, edit B</opt/etc/init.d/S80squid> so that it looks like this:<br />
<source lang="text"><br />
#! /bin/sh<br />
<br />
case "$1" in<br />
start)<br />
echo -n "Starting proxy server: "<br />
if [ -n "`pidof quotacheck`" ]; then<br />
#you don't need it if you don't have quota check enable.<br />
echo "Starting squid-cache server after delay for few mins:"<br />
/opt/etc/squid/squid.delay-start.sh&amp;<br />
else<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf<br />
iptables -t nat -A OUTPUT -p tcp --dport 80 -m owner --gid-owner 65534 -j ACCEPT<br />
iptables -t nat -A OUTPUT -p tcp --dport 80 -j DNAT --to-destination 127.0.0.1:3128<br />
echo "done."<br />
fi<br />
echo "done."<br />
;;<br />
stop)<br />
echo -n "Stopping proxy server: "<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf -k shutdown<br />
iptables -t nat -D OUTPUT -p tcp --dport 80 -m owner --gid-owner 65534 -j ACCEPT<br />
iptables -t nat -D OUTPUT -p tcp --dport 80 -j DNAT --to-destination 127.0.0.1:3128<br />
echo "done."<br />
;;<br />
reload|force-reload)<br />
echo -n "Reloading proxy server configuration files: "<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf -k reconfigure<br />
echo "done."<br />
;;<br />
restart)<br />
echo -n "Restarting proxy server: "<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf -k shutdown<br />
sleep 2<br />
/opt/sbin/squid -f /opt/etc/squid/squid.conf<br />
echo "done."<br />
;;<br />
*)<br />
echo "Usage: /opt/etc/init.d/S80squid {start|stop|reload|force-reload|restart}"<br />
exit 1<br />
;;<br />
esac<br />
</source><br />
<br />
== Configure network to startup squid if WLAN comes up ==<br />
<br />
Now we need to alter the behavior of the palm network manager so that it starts squid if WIFI comes up and stops it when WIFI goes down.<br />
<br />
Change to directory ''/etc/pmnetconfig/''.<br />
<br />
In the file ''if-up'' modify this part:<br />
<source lang="text"<br />
if [ "$ISPPP" -ne 4 ] &amp;&amp; [ "$ISRMNET" -ne 6 ] &amp;&amp; [ "$ISTUN" -ne 4 ] &amp;&amp; [ "$ISCSCOTUNVPN" -ne 8 ]; then<br />
NetCfgSetAddr<br />
CMSERVICES=$((${CMSERVICES} | ${CMSVCINTERNET}))<br />
fi<br />
</source><br />
to<br />
<source lang="text"<br />
if [ "$ISPPP" -ne 4 ] &amp;&amp; [ "$ISRMNET" -ne 6 ] &amp;&amp; [ "$ISTUN" -ne 4 ] &amp;&amp; [ "$ISCSCOTUNVPN" -ne 8 ]; then<br />
NetCfgSetAddr<br />
CMSERVICES=$((${CMSERVICES} | ${CMSVCINTERNET}))<br />
/usr/bin/logger "wifi up: execute /opt/etc/init.d/S80squid start" <br />
/opt/etc/init.d/S80squid start<br />
fi<br />
</source><br />
In the file ''if-down'' modify this part:<br />
<source lang="text"<br />
if [ ${CMINTERFACE} = ${CMBTINTERFACENAME} ] || [ ${CMINTERFACE} = ${CMBRINTERFACENAME} ]; then<br />
${LOG} "${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE"<br />
${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE<br />
${LOG} "${ECHO} 0 >/proc/sys/net/ipv4/ip_forward"<br />
${ECHO} 0 >/proc/sys/net/ipv4/ip_forward<br />
fi <br />
</source><br />
to:<br />
<source lang="text"<br />
if [ ${CMINTERFACE} = ${CMBTINTERFACENAME} ] || [ ${CMINTERFACE} = ${CMBRINTERFACENAME} ]; then<br />
${LOG} "${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE"<br />
${IPTABLES} -t nat -D POSTROUTING -s $CMNETADDR/$CMPREFIXLEN -j MASQUERADE<br />
${LOG} "${ECHO} 0 >/proc/sys/net/ipv4/ip_forward"<br />
${ECHO} 0 >/proc/sys/net/ipv4/ip_forward<br />
/usr/bin/logger "wifi up: execute /opt/etc/init.d/S80squid stop" <br />
/opt/etc/init.d/S80squid stop <br />
fi <br />
</source><br />
<br />
<br />
== See it working ==<br />
<br />
So, let's see how it works. Enable WIFI and fire up the browser and see if it works. You should see your requests on the remote proxy.<br />
<br />
If you added an ACL as mentioned earlier, a message like the following should appear if you enter the url of your favourite enemy vendor (the one we configured above):<br />
<br />
[[Image:Squid-access-denied-palm-pre.png]]<br />
<br />
== Blocking Adverts ==<br />
<br />
Now squid is set up, we can use it for ad blocking. There are two steps to this:<br />
<br />
=== Obtain a block list ===<br />
<br />
An excellent ad block list is maintained at [http://pgl.yoyo.org/as/]. We need to download it in a suitable format for squid, which can be done by running the following command:<br />
<br />
<source lang="text"><br />
wget -q -O - 'http://pgl.yoyo.org/as/serverlist.php?hostformat=squid-dstdom-regex;showintro=0' | grep -v ">" | grep "." > /opt/etc/squid/blocklist<br />
</source><br />
<br />
(Technical details: the wget command downloads the URL given in single quotes, then we strip the HTML mark-up and blank lines using grep. The filename at the end is where the black list will be stored.)<br />
<br />
=== Configure squid to use the block list ===<br />
<br />
Now we need to tell squid to block the list of URLs in the file we've just created. Open the ''/opt/etc/squid/squid.conf'' file we created above, and scroll down to where it reads:<br />
<br />
<source lang="text"><br />
acl enemy dstdomain www.apple.com<br />
</source><br />
<br />
Replace this line with:<br />
<br />
<source lang="text"><br />
acl enemy dstdom_regex "/opt/etc/squid/blocklist"<br />
</source><br />
<br />
Finally, restart squid:<br />
<br />
<source lang="text"><br />
/opt/etc/init.d/S80squid restart<br />
</source><br />
<br />
To test it's working, open a browser and try to visit ''ads.msn.com'' (one of the blocked URLs). The error given should be similar to the screenshot given above.<br />
<br />
If in the future you need to update the ad blocking list, run the commands:<br />
<br />
<source lang="text"><br />
cd / && mount -v -o remount,rw /<br />
wget -q -O - 'http://pgl.yoyo.org/as/serverlist.php?hostformat=squid-dstdom-regex;showintro=0' | grep -v ">" | grep "." > /opt/etc/squid/blocklist<br />
/opt/etc/init.d/S80squid restart<br />
</source><br />
<br />
For further details of filtering URLs using squid, please refer to the [http://www.squid-cache.org/Doc/ excelent documentation of the squid cache project].</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=File:Fishfillets-Keyboard-320.png&diff=9078File:Fishfillets-Keyboard-320.png2010-02-16T22:55:09Z<p>Debilater: </p>
<hr />
<div></div>Debilaterhttp://wiki.webos-internals.org/index.php?title=File:FishFillet-Keyboard-665.png&diff=9069File:FishFillet-Keyboard-665.png2010-02-15T23:54:58Z<p>Debilater: </p>
<hr />
<div></div>Debilaterhttp://wiki.webos-internals.org/index.php?title=File:Fishfillets-credits.png&diff=9037File:Fishfillets-credits.png2010-02-13T23:22:57Z<p>Debilater: </p>
<hr />
<div></div>Debilaterhttp://wiki.webos-internals.org/index.php?title=File:Fishfillets-options.png&diff=9036File:Fishfillets-options.png2010-02-13T23:22:30Z<p>Debilater: </p>
<hr />
<div></div>Debilaterhttp://wiki.webos-internals.org/index.php?title=File:Fishfillets-level.png&diff=9035File:Fishfillets-level.png2010-02-13T23:22:00Z<p>Debilater: </p>
<hr />
<div></div>Debilaterhttp://wiki.webos-internals.org/index.php?title=File:Fishfillets-map.png&diff=9034File:Fishfillets-map.png2010-02-13T23:21:26Z<p>Debilater: </p>
<hr />
<div></div>Debilaterhttp://wiki.webos-internals.org/index.php?title=File:Photos_2010-12-02_231007.png&diff=9032File:Photos 2010-12-02 231007.png2010-02-12T22:11:56Z<p>Debilater: </p>
<hr />
<div></div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Application:Stella&diff=9014Application:Stella2010-02-10T12:26:00Z<p>Debilater: </p>
<hr />
<div>[[Category:SDL]]<br />
<br />
{{application<br />
|name=Stella<br />
|type=webOS<br />
|version=Version: Alpha 3.0.0 <br />(10. Feb 2010)<br />
|tag=Games<br />
|screenshot=Romlauncher.png<br />
|description=<br />
<br />
=Stella Atari 2600 VCS Emulator 3.0=<br />
[[Image:Stella_icon.png]]Stella is a multi-platform Atari 2600 VCS emulator released under the GNU General Public License (GPL).<br />
<br />
=Credit=<br />
Ported by [http://www.daemon.de/PalmPre Thomas Linden (debilater)] February 2010.<br />
<br />
=Thanks=<br />
First Thanks goes to my beloved wife Leo, without her patience and support I couldn't ever make this happen! Thanks goes to the Stella development team for this awesome emulator! Thanks to the webos-internals team for their hard work on [[WebOS_Internals_PDK|WIDK]]!<br />
<br />
=Donate=<br />
As you might assume, porting software to the palm pre webOS platform is a lot of work, so please consider to [[WebOS_Internals:Site_support|donate]] to the project so that the work can be continued in the future. Thanks!<br />
<br />
=License=<br />
All source is under the GPL license.<br />
The original source code is available [http://stella.sourceforge.net/downloads.php here]<br /><br />
And the latest "Stella Atari 2600 VCS Emulator" for webOS source is available on git [http://git.webos-internals.org/?p=games/stella.git here] <br /><br />
<br />
== Installing VBA ==<br />
Install [[Preware]], and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "stella" (no quotes). Stella should show up. If not, make sure your feeds are up to date. Click on Stella and then click install. You will probably have to install other services as well (it will tell you if you do).<br />
<br/><br />
<br />
Now you are ready to add ROMs(games)!<br />
<br />
==Adding ROMS==<br />
We aren't going to discuss how to get ROMs here but we will tell you how to transfer them to your Pre. (there are some links to free roms on the bottom).<br />
<br />
You may use .a26, .bin, .rom, gz, or .zip Atari 2600 ROM files.<br />
<br />
Connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", "ringtones", and most importantly, a "stella" folder. Click on that and therein the "roms" folder. Copy the ROMs from your computer and move them here. Just put the files there, do not create subdirectories.<br />
<br />
==Controls==<br />
If you have installed some ROM files, start Stella, you will see a list of games available. Select one by tapping on it and tap on the "select" button in the bottom left corner - the game starts. You might also enter some letters, the cursor will then jump to the possition in the list (if there is a match).<br />
<br />
Here is the default Keymapping coming with Stella for webOS:<br />
<br />
* up - w<br />
* down - s<br />
* left - a<br />
* right - d<br />
* jump - space (originally called fire1 too)<br />
* fire2 - f<br />
* fire3 - g<br />
* select - enter<br />
* reset - q<br />
* save - shift<br />
* load - l<br />
* take screenshot - p<br />
* options-menu - delete<br />
* command-menu - c<br />
* close popups - swipe right-to-left (probably ESC)<br />
<br />
==The most important things to know==<br />
<br />
* ''start game'': press space bar<br />
* ''move around'': use w,s,a,d keys (see above)<br />
* ''fire/jump'': press spacebar<br />
* ''switch to landscape mode'': press Delete on keyboard => tap "UI Settings" => tap "Fullscreen" => select "off" => tap button "Ok"<br />
* ''modify keymappings'': press Delete on keyboard => tap "Input Settings" => select a function (current mapping will be displayed below!) => tap "Map" => press the new key => tap "Ok"<br />
* ''take screenshot'': press "p", screenshots will be saved to "/media/internals/stella/screenshots/"<br />
* ''exit current game/return to ROM Launcher'': press "c" key => tap "Exit Game"<br />
* ''exit Stella'': throw it away OR tap "Quit" in ROM Launcher<br />
<br />
=User Guide=<br />
Please don't miss the complete [http://stella.sourceforge.net/docs/index.html Original Stella Userguide]. It will answer all the questions.<br />
<br />
=F.A.Q.=<br />
<br />
==I've bricked my config - stella doesn't start anymore or is unusable!==<br />
Delete the file /media/internals/stella/config/stellarc and start Stella again, it will create a new config with the builtin default parameters<br />
<br />
==Re-Mapping Keys in the Input Preferences Dialog is a nightmare, is there any better way to do it?==<br />
Unfortunately: nope. You might edit the config file but the keymapping format is not human understandable. Sorry!<br />
<br />
==Stella crashed and my phone boots, help!==<br />
From time to time the app crashes and under some rare conditions it takes Luna (webOS GUI Manager) with it. Don't worry, at least it won't destroy anything.<br />
<br />
==Where can I get further help?==<br />
* Post a message to the [http://forums.precentral.net/webos-internals/229753-stella-atari-2600-vcs-emulator.html Stella Forum Thread]<br />
* [https://www.nomed.de/forum/read.php?40,20944 Deutsches Supportforum]<br />
<br />
=Screenshots=<br />
<gallery><br />
Image:Romlauncher.png|ROM Launcher<br />
Image:Stella_About.png|About dialog<br />
Image:Stella_Settings.png|Settings menu<br />
Image:Crazy_Climber_(1982)_(Atari).png|Game: Crazy Climber<br />
Image:Demon_Attack_(1982)_(Imagic).png|Game: Demon Attack<br />
Image:Mario_Bros._(1983)_(Atari).png|Game: Mario Bros<br />
Image:SwordQuest_-_WaterWorld_(1983)_(Atari).png|Game: Sword Quest<br />
Image:Quadrun_(1983)_(Atari)_(Prototype).png|Game: Quadrun<br />
</gallery><br />
<br />
=Some Free ROMs=<br />
* [http://usfiles.brothersoft.com/games/emulator/atari/River_Raid.zip River Raid]<br />
* [http://roms.freeroms.com/atari_roms/ateam.zip A-Team]<br />
* [http://roms.freeroms.com/atari_roms/hero.zip H.E.R.O.]<br />
<br />
=Feature Requests/TODO=<br />
<br />
=Known issues=<br />
* Stella crashes if you switch from portrait mode (the default) to landscape mode. Open bug reported to stella maintainer (debilater)<br />
* taking screenshots with the palm (orange+@+p) produces empty images<br />
* if you put stella into the background, the command menu appears<br />
* switching to landscape view from stella freezes the app (it works from commandline though)<br />
<br />
=Changelog=<br />
* '''0.0.1'''<br />
** Initial version (stella 3.0 stable)<br />
<br />
}}</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Application:Stella&diff=9013Application:Stella2010-02-10T12:19:21Z<p>Debilater: </p>
<hr />
<div>[[Category:SDL]]<br />
<br />
{{application<br />
|name=Stella<br />
|type=webOS<br />
|version=Version: Alpha 3.0.0 <br />(10. Feb 2010)<br />
|tag=Games<br />
|screenshot=Romlauncher.png<br />
|description=<br />
<br />
=Stella Atari 2600 VCS Emulator 3.0=<br />
[[Image:Stella_icon.png]]Stella is a multi-platform Atari 2600 VCS emulator released under the GNU General Public License (GPL).<br />
<br />
=Credit=<br />
Ported by [http://www.daemon.de/PalmPre Thomas Linden (debilater)] February 2010.<br />
<br />
=Thanks=<br />
First Thanks goes to my beloved wife Leo, without her patience and support I couldn't ever make this happen! Thanks goes to the Stella development team for this awesome emulator! Thanks to the webos-internals team for their hard work on [[WebOS_Internals_PDK|WIDK]]!<br />
<br />
=Donate=<br />
As you might assume, porting software to the palm pre webOS platform is a lot of work, so please consider to [[WebOS_Internals:Site_support|donate]] to the project so that the work can be continued in the future. Thanks!<br />
<br />
=License=<br />
All source is under the GPL license.<br />
The original source code is available [http://stella.sourceforge.net/downloads.php here]<br /><br />
And the latest "Stella Atari 2600 VCS Emulator" for webOS source is available on git [http://git.webos-internals.org/?p=games/stella.git here] <br /><br />
<br />
== Installing VBA ==<br />
Install [[Preware]], and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "stella" (no quotes). Stella should show up. If not, make sure your feeds are up to date. Click on Stella and then click install. You will probably have to install other services as well (it will tell you if you do).<br />
<br/><br />
<br />
Now you are ready to add ROMs(games)!<br />
<br />
==Adding ROMS==<br />
We aren't going to discuss how to get ROMs here but we will tell you how to transfer them to your Pre. (there are some links to free roms on the bottom).<br />
<br />
You may use .a26, .bin, .rom, gz, or .zip Atari 2600 ROM files.<br />
<br />
Connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", "ringtones", and most importantly, a "stella" folder. Click on that and therein the "roms" folder. Copy the ROMs from your computer and move them here. Just put the files there, do not create subdirectories.<br />
<br />
==Controls==<br />
If you have installed some ROM files, start Stella, you will see a list of games available. Select one by tapping on it and tap on the "select" button in the bottom left corner - the game starts. You might also enter some letters, the cursor will then jump to the possition in the list (if there is a match).<br />
<br />
Here is the default Keymapping coming with Stella for webOS:<br />
<br />
* up - w<br />
* down - s<br />
* left - a<br />
* right - d<br />
* jump - space (originally called fire1 too)<br />
* fire2 - f<br />
* fire3 - g<br />
* select - enter<br />
* reset - q<br />
* save - shift<br />
* load - l<br />
* take screenshot - p<br />
* options-menu - delete<br />
* command-menu - c<br />
* close popups - swipe right-to-left (probably ESC)<br />
<br />
==The most important things to know==<br />
<br />
* ''start game'': press space bar<br />
* ''move around'': use w,s,a,d keys (see above)<br />
* ''fire/jump'': press spacebar<br />
* ''switch to landscape mode'': press Delete on keyboard => tap "UI Settings" => tap "Fullscreen" => select "off" => tap button "Ok"<br />
* ''modify keymappings'': press Delete on keyboard => tap "Input Settings" => select a function (current mapping will be displayed below!) => tap "Map" => press the new key => tap "Ok"<br />
* ''take screenshot'': press "p", screenshots will be saved to "/media/internals/stella/screenshots/"<br />
* ''exit current game/return to ROM Launcher'': press "c" key => tap "Exit Game"<br />
* ''exit Stella'': throw it away OR tap "Quit" in ROM Launcher<br />
<br />
=User Guide=<br />
Please don't miss the complete [http://stella.sourceforge.net/docs/index.html Original Stella Userguide]. It will answer all the questions.<br />
<br />
=F.A.Q.=<br />
<br />
==I've bricked my config - stella doesn't start anymore or is unusable!==<br />
Delete the file /media/internals/stella/config/stellarc and start Stella again, it will create a new config with the builtin default parameters<br />
<br />
==Re-Mapping Keys in the Input Preferences Dialog is a nightmare, is there any better way to do it?==<br />
Unfortunately: nope. You might edit the config file but the keymapping format is not human understandable. Sorry!<br />
<br />
==Stella crashed and my phone boots, help!==<br />
From time to time the app crashes and under some rare conditions it takes Luna (webOS GUI Manager) with it. Don't worry, at least it won't destroy anything.<br />
<br />
==Where can I get further help?==<br />
* Post a message to the [http://forums.precentral.net/2212763-post1.html Stella Forum Thread]<br />
* [https://www.nomed.de/forum/read.php?40,20944 Deutsches Supportforum]<br />
<br />
=Screenshots=<br />
<gallery><br />
Image:Romlauncher.png|ROM Launcher<br />
Image:Stella_About.png|About dialog<br />
Image:Stella_Settings.png|Settings menu<br />
Image:Crazy_Climber_(1982)_(Atari).png|Game: Crazy Climber<br />
Image:Demon_Attack_(1982)_(Imagic).png|Game: Demon Attack<br />
Image:Mario_Bros._(1983)_(Atari).png|Game: Mario Bros<br />
Image:SwordQuest_-_WaterWorld_(1983)_(Atari).png|Game: Sword Quest<br />
Image:Quadrun_(1983)_(Atari)_(Prototype).png|Game: Quadrun<br />
</gallery><br />
<br />
=Some Free ROMs=<br />
* [http://usfiles.brothersoft.com/games/emulator/atari/River_Raid.zip River Raid]<br />
* [http://roms.freeroms.com/atari_roms/ateam.zip A-Team]<br />
* [http://roms.freeroms.com/atari_roms/hero.zip H.E.R.O.]<br />
<br />
=Feature Requests/TODO=<br />
<br />
=Known issues=<br />
* Stella crashes if you switch from portrait mode (the default) to landscape mode. Open bug reported to stella maintainer (debilater)<br />
* taking screenshots with the palm (orange+@+p) produces empty images<br />
* if you put stella into the background, the command menu appears<br />
* switching to landscape view from stella freezes the app (it works from commandline though)<br />
<br />
=Changelog=<br />
* '''0.0.1'''<br />
** Initial version (stella 3.0 stable)<br />
<br />
}}</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Application:Stella&diff=9012Application:Stella2010-02-10T12:17:28Z<p>Debilater: </p>
<hr />
<div>[[Category:SDL]]<br />
<br />
{{application<br />
|name=Stella<br />
|type=webOS<br />
|version=Version: Alpha 3.0.0 <br />(10. Feb 2010)<br />
|tag=Games<br />
|screenshot=Romlauncher.png<br />
|description=<br />
<br />
=Stella Atari 2600 VCS Emulator 3.0=<br />
[[Image:Stella_icon.png]]Stella is a multi-platform Atari 2600 VCS emulator released under the GNU General Public License (GPL).<br />
<br />
=Credit=<br />
Ported by [http://www.daemon.de/PalmPre Thomas Linden (debilater)] February 2010.<br />
<br />
=Thanks=<br />
First Thanks goes to my beloved wife Leo, without her patience and support I couldn't ever make this happen! Thanks goes to the Stella development team for this awesome emulator! Thanks to the webos-internals team for their hard work on [[WebOS_Internals_PDK|WIDK]]!<br />
<br />
=Donate=<br />
As you might assume, porting software to the palm pre webOS platform is a lot of work, so please consider to [[WebOS_Internals:Site_support|donate]] to the project so that the work can be continued in the future. Thanks!<br />
<br />
=License=<br />
All source is under the GPL license.<br />
The original source code is available [http://stella.sourceforge.net/downloads.php here]<br /><br />
And the latest "Stella Atari 2600 VCS Emulator" for webOS source is available on git [http://git.webos-internals.org/?p=games/stella.git here] <br /><br />
<br />
== Installing VBA ==<br />
Install [[Preware]], and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "stella" (no quotes). Stella should show up. If not, make sure your feeds are up to date. Click on Stella and then click install. You will probably have to install other services as well (it will tell you if you do).<br />
<br/><br />
<br />
Now you are ready to add ROMs(games)!<br />
<br />
==Adding ROMS==<br />
We aren't going to discuss how to get ROMs here but we will tell you how to transfer them to your Pre. (there are some links to free roms on the bottom).<br />
<br />
You may use .a26, .bin, .rom, gz, or .zip Atari 2600 ROM files.<br />
<br />
Connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", "ringtones", and most importantly, a "stella" folder. Click on that and therein the "roms" folder. Copy the ROMs from your computer and move them here. Just put the files there, do not create subdirectories.<br />
<br />
==Controls==<br />
If you have installed some ROM files, start Stella, you will see a list of games available. Select one by tapping on it and tap on the "select" button in the bottom left corner - the game starts. You might also enter some letters, the cursor will then jump to the possition in the list (if there is a match).<br />
<br />
Here is the default Keymapping coming with Stella for webOS:<br />
<br />
* up - w<br />
* down - s<br />
* left - a<br />
* right - d<br />
* jump - space (originally called fire1 too)<br />
* fire2 - f<br />
* fire3 - g<br />
* select - enter<br />
* reset - q<br />
* save - shift<br />
* load - l<br />
* take screenshot - p<br />
* options-menu - delete<br />
* command-menu - c<br />
* close popups - swipe right-to-left (probably ESC)<br />
<br />
==The most important things to know==<br />
<br />
* ''start game'': press space bar<br />
* ''move around'': use w,s,a,d keys (see above)<br />
* ''fire/jump'': press spacebar<br />
* ''switch to landscape mode'': press Delete on keyboard => tap "UI Settings" => tap "Fullscreen" => select "off" => tap button "Ok"<br />
* ''modify keymappings'': press Delete on keyboard => tap "Input Settings" => select a function (current mapping will be displayed below!) => tap "Map" => press the new key => tap "Ok"<br />
* ''take screenshot'': press "p", screenshots will be saved to "/media/internals/stella/screenshots/"<br />
* ''exit current game/return to ROM Launcher'': press "c" key => tap "Exit Game"<br />
* ''exit Stella'': throw it away OR tap "Quit" in ROM Launcher<br />
<br />
=User Guide=<br />
Please don't miss the complete [http://stella.sourceforge.net/docs/index.html Original Stella Userguide]. It will answer all the questions.<br />
<br />
=F.A.Q.=<br />
<br />
==I've bricked my config - stella doesn't start anymore or is unusable!==<br />
Delete the file /media/internals/stella/config/stellarc and start Stella again, it will create a new config with the builtin default parameters<br />
<br />
==Re-Mapping Keys in the Input Preferences Dialog is a nightmare, is there any better way to do it?==<br />
Unfortunately: nope. You might edit the config file but the keymapping format is not human understandable. Sorry!<br />
<br />
==Stella crashed and my phone boots, help!==<br />
From time to time the app crashes and under some rare conditions it takes Luna (webOS GUI Manager) with it. Don't worry, at least it won't destroy anything.<br />
<br />
==Where can I get further help?==<br />
* Post a message to the Stella Forum Thread: ''FIXME''<br />
* [https://www.nomed.de/forum/read.php?40,20944 Deutsches Supportforum]<br />
<br />
=Screenshots=<br />
<gallery><br />
Image:Romlauncher.png|ROM Launcher<br />
Image:Stella_About.png|About dialog<br />
Image:Stella_Settings.png|Settings menu<br />
Image:Crazy_Climber_(1982)_(Atari).png|Game: Crazy Climber<br />
Image:Demon_Attack_(1982)_(Imagic).png|Game: Demon Attack<br />
Image:Mario_Bros._(1983)_(Atari).png|Game: Mario Bros<br />
Image:SwordQuest_-_WaterWorld_(1983)_(Atari).png|Game: Sword Quest<br />
Image:Quadrun_(1983)_(Atari)_(Prototype).png|Game: Quadrun<br />
</gallery><br />
<br />
=Some Free ROMs=<br />
* [http://usfiles.brothersoft.com/games/emulator/atari/River_Raid.zip River Raid]<br />
* [http://roms.freeroms.com/atari_roms/ateam.zip A-Team]<br />
* [http://roms.freeroms.com/atari_roms/hero.zip H.E.R.O.]<br />
<br />
=Feature Requests/TODO=<br />
<br />
=Known issues=<br />
* Stella crashes if you switch from portrait mode (the default) to landscape mode. Open bug reported to stella maintainer (debilater)<br />
* taking screenshots with the palm (orange+@+p) produces empty images<br />
* if you put stella into the background, the command menu appears<br />
* switching to landscape view from stella freezes the app (it works from commandline though)<br />
<br />
=Changelog=<br />
* '''0.0.1'''<br />
** Initial version (stella 3.0 stable)<br />
<br />
}}</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Application:Stella&diff=9011Application:Stella2010-02-10T12:17:11Z<p>Debilater: </p>
<hr />
<div>[[Category:SDL]]<br />
<br />
{{application<br />
|name=Stella<br />
|type=webOS<br />
|version=Version: Alpha 0.0.1 <br />(10. Feb 2010)<br />
|tag=Games<br />
|screenshot=Romlauncher.png<br />
|description=<br />
<br />
=Stella Atari 2600 VCS Emulator 3.0=<br />
[[Image:Stella_icon.png]]Stella is a multi-platform Atari 2600 VCS emulator released under the GNU General Public License (GPL).<br />
<br />
=Credit=<br />
Ported by [http://www.daemon.de/PalmPre Thomas Linden (debilater)] February 2010.<br />
<br />
=Thanks=<br />
First Thanks goes to my beloved wife Leo, without her patience and support I couldn't ever make this happen! Thanks goes to the Stella development team for this awesome emulator! Thanks to the webos-internals team for their hard work on [[WebOS_Internals_PDK|WIDK]]!<br />
<br />
=Donate=<br />
As you might assume, porting software to the palm pre webOS platform is a lot of work, so please consider to [[WebOS_Internals:Site_support|donate]] to the project so that the work can be continued in the future. Thanks!<br />
<br />
=License=<br />
All source is under the GPL license.<br />
The original source code is available [http://stella.sourceforge.net/downloads.php here]<br /><br />
And the latest "Stella Atari 2600 VCS Emulator" for webOS source is available on git [http://git.webos-internals.org/?p=games/stella.git here] <br /><br />
<br />
== Installing VBA ==<br />
Install [[Preware]], and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "stella" (no quotes). Stella should show up. If not, make sure your feeds are up to date. Click on Stella and then click install. You will probably have to install other services as well (it will tell you if you do).<br />
<br/><br />
<br />
Now you are ready to add ROMs(games)!<br />
<br />
==Adding ROMS==<br />
We aren't going to discuss how to get ROMs here but we will tell you how to transfer them to your Pre. (there are some links to free roms on the bottom).<br />
<br />
You may use .a26, .bin, .rom, gz, or .zip Atari 2600 ROM files.<br />
<br />
Connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", "ringtones", and most importantly, a "stella" folder. Click on that and therein the "roms" folder. Copy the ROMs from your computer and move them here. Just put the files there, do not create subdirectories.<br />
<br />
==Controls==<br />
If you have installed some ROM files, start Stella, you will see a list of games available. Select one by tapping on it and tap on the "select" button in the bottom left corner - the game starts. You might also enter some letters, the cursor will then jump to the possition in the list (if there is a match).<br />
<br />
Here is the default Keymapping coming with Stella for webOS:<br />
<br />
* up - w<br />
* down - s<br />
* left - a<br />
* right - d<br />
* jump - space (originally called fire1 too)<br />
* fire2 - f<br />
* fire3 - g<br />
* select - enter<br />
* reset - q<br />
* save - shift<br />
* load - l<br />
* take screenshot - p<br />
* options-menu - delete<br />
* command-menu - c<br />
* close popups - swipe right-to-left (probably ESC)<br />
<br />
==The most important things to know==<br />
<br />
* ''start game'': press space bar<br />
* ''move around'': use w,s,a,d keys (see above)<br />
* ''fire/jump'': press spacebar<br />
* ''switch to landscape mode'': press Delete on keyboard => tap "UI Settings" => tap "Fullscreen" => select "off" => tap button "Ok"<br />
* ''modify keymappings'': press Delete on keyboard => tap "Input Settings" => select a function (current mapping will be displayed below!) => tap "Map" => press the new key => tap "Ok"<br />
* ''take screenshot'': press "p", screenshots will be saved to "/media/internals/stella/screenshots/"<br />
* ''exit current game/return to ROM Launcher'': press "c" key => tap "Exit Game"<br />
* ''exit Stella'': throw it away OR tap "Quit" in ROM Launcher<br />
<br />
=User Guide=<br />
Please don't miss the complete [http://stella.sourceforge.net/docs/index.html Original Stella Userguide]. It will answer all the questions.<br />
<br />
=F.A.Q.=<br />
<br />
==I've bricked my config - stella doesn't start anymore or is unusable!==<br />
Delete the file /media/internals/stella/config/stellarc and start Stella again, it will create a new config with the builtin default parameters<br />
<br />
==Re-Mapping Keys in the Input Preferences Dialog is a nightmare, is there any better way to do it?==<br />
Unfortunately: nope. You might edit the config file but the keymapping format is not human understandable. Sorry!<br />
<br />
==Stella crashed and my phone boots, help!==<br />
From time to time the app crashes and under some rare conditions it takes Luna (webOS GUI Manager) with it. Don't worry, at least it won't destroy anything.<br />
<br />
==Where can I get further help?==<br />
* Post a message to the Stella Forum Thread: ''FIXME''<br />
* [https://www.nomed.de/forum/read.php?40,20944 Deutsches Supportforum]<br />
<br />
=Screenshots=<br />
<gallery><br />
Image:Romlauncher.png|ROM Launcher<br />
Image:Stella_About.png|About dialog<br />
Image:Stella_Settings.png|Settings menu<br />
Image:Crazy_Climber_(1982)_(Atari).png|Game: Crazy Climber<br />
Image:Demon_Attack_(1982)_(Imagic).png|Game: Demon Attack<br />
Image:Mario_Bros._(1983)_(Atari).png|Game: Mario Bros<br />
Image:SwordQuest_-_WaterWorld_(1983)_(Atari).png|Game: Sword Quest<br />
Image:Quadrun_(1983)_(Atari)_(Prototype).png|Game: Quadrun<br />
</gallery><br />
<br />
=Some Free ROMs=<br />
* [http://usfiles.brothersoft.com/games/emulator/atari/River_Raid.zip River Raid]<br />
* [http://roms.freeroms.com/atari_roms/ateam.zip A-Team]<br />
* [http://roms.freeroms.com/atari_roms/hero.zip H.E.R.O.]<br />
<br />
=Feature Requests/TODO=<br />
<br />
=Known issues=<br />
* Stella crashes if you switch from portrait mode (the default) to landscape mode. Open bug reported to stella maintainer (debilater)<br />
* taking screenshots with the palm (orange+@+p) produces empty images<br />
* if you put stella into the background, the command menu appears<br />
* switching to landscape view from stella freezes the app (it works from commandline though)<br />
<br />
=Changelog=<br />
* '''0.0.1'''<br />
** Initial version (stella 3.0 stable)<br />
<br />
}}</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Application:Stella&diff=9010Application:Stella2010-02-10T11:50:49Z<p>Debilater: </p>
<hr />
<div>[[Category:SDL]]<br />
<br />
{{application<br />
|name=Stella<br />
|type=webOS<br />
|version=Version: Alpha 0.0.1 <br />(10. Feb 2010)<br />
|tag=Games<br />
|screenshot=Romlauncher.png<br />
|description=<br />
<br />
=Stella Atari 2600 VCS Emulator 3.0=<br />
[[Image:Stella_icon.png]]Stella is a multi-platform Atari 2600 VCS emulator released under the GNU General Public License (GPL).<br />
<br />
=Credit=<br />
Ported by [http://www.daemon.de/PalmPre Thomas Linden (debilater)] February 2010.<br />
<br />
=Thanks=<br />
First Thanks goes to my beloved wife Leo, without her patience and support I couldn't ever make this happen! Thanks goes to the Stella development team for this awesome emulator! Thanks to the webos-internals team for their hard work on [[WebOS_Internals_PDK|WIDK]]!<br />
<br />
=Donate=<br />
As you might assume, porting software to the palm pre webOS platform is a lot of work, so please consider to [[WebOS_Internals:Site_support|donate]] to the project so that the work can be continued in the future. Thanks!<br />
<br />
=License=<br />
All source is under the GPL license.<br />
The original source code is available [http://stella.sourceforge.net/downloads.php here]<br /><br />
And the latest "Stella Atari 2600 VCS Emulator" for webOS source is available on git [http://git.webos-internals.org/?p=games/stella.git here] <br /><br />
<br />
== Installing VBA ==<br />
Install [[Preware]], and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "stella" (no quotes). Stella should show up. If not, make sure your feeds are up to date. Click on Stella and then click install. You will probably have to install other services as well (it will tell you if you do).<br />
<br/><br />
<br />
Now you are ready to add ROMs(games)!<br />
<br />
==Adding ROMS==<br />
We aren't going to discuss how to get ROMs here but we will tell you how to transfer them to your Pre. (there are some links to free roms on the bottom).<br />
<br />
You may use .a26, .bin, .rom, gz, or .zip Atari 2600 ROM files.<br />
<br />
Connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", "ringtones", and most importantly, a "stella" folder. Click on that and therein the "roms" folder. Copy the ROMs from your computer and move them here. Just put the files there, do not create subdirectories.<br />
<br />
==Controls==<br />
If you have installed some ROM files, start Stella, you will see a list of games available. Select one by tapping on it and tap on the "select" button in the bottom left corner - the game starts. You might also enter some letters, the cursor will then jump to the possition in the list (if there is a match).<br />
<br />
Here is the default Keymapping coming with Stella for webOS:<br />
<br />
* up - w<br />
* down - s<br />
* left - a<br />
* right - d<br />
* jump - space (originally called fire1 too)<br />
* fire2 - f<br />
* fire3 - g<br />
* select - enter<br />
* reset - q<br />
* save - shift<br />
* load - l<br />
* take screenshot - p<br />
* options-menu - delete<br />
* command-menu - c<br />
* close popups - swipe right-to-left (probably ESC)<br />
<br />
==The most important things to know==<br />
<br />
* ''start game'': press space bar<br />
* ''move around'': use w,s,a,d keys (see above)<br />
* ''fire/jump'': press spacebar<br />
* ''switch to landscape mode'': press Delete on keyboard => tap "UI Settings" => tap "Fullscreen" => select "off" => tap button "Ok"<br />
* ''modify keymappings'': press Delete on keyboard => tap "Input Settings" => select a function (current mapping will be displayed below!) => tap "Map" => press the new key => tap "Ok"<br />
* ''take screenshot'': press "p", screenshots will be saved to "/media/internals/stella/screenshots/"<br />
* ''exit current game/return to ROM Launcher'': press "c" key => tap "Exit Game"<br />
* ''exit Stella'': throw it away OR tap "Quit" in ROM Launcher<br />
<br />
=User Guide=<br />
Please don't miss the complete [http://stella.sourceforge.net/docs/index.html Original Stella Userguide]. It will answer all the questions.<br />
<br />
=F.A.Q.=<br />
<br />
==I've bricked my config - stella doesn't start anymore or is unusable!==<br />
Delete the file /media/internals/stella/config/stellarc and start Stella again, it will create a new config with the builtin default parameters<br />
<br />
==Re-Mapping Keys in the Input Preferences Dialog is a nightmare, is there any better way to do it?==<br />
Unfortunately: nope. You might edit the config file but the keymapping format is not human understandable. Sorry!<br />
<br />
==Stella crashed and my phone boots, help!==<br />
From time to time the app crashes and under some rare conditions it takes Luna (webOS GUI Manager) with it. Don't worry, at least it won't destroy anything.<br />
<br />
==Where can I get further help?==<br />
* Post a message to the Stella Forum Thread: ''FIXME''<br />
* [https://www.nomed.de/forum/read.php?40,20944 Deutsches Supportforum]<br />
<br />
=Screenshots=<br />
<gallery><br />
Image:Romlauncher.png|ROM Launcher<br />
Image:Stella_About.png|About dialog<br />
Image:Stella_Settings.png|Settings menu<br />
Image:Crazy_Climber_(1982)_(Atari).png|Game: Crazy Climber<br />
Image:Demon_Attack_(1982)_(Imagic).png|Game: Demon Attack<br />
Image:Mario_Bros._(1983)_(Atari).png|Game: Mario Bros<br />
Image:SwordQuest_-_WaterWorld_(1983)_(Atari).png|Game: Sword Quest<br />
Image:Quadrun_(1983)_(Atari)_(Prototype).png|Game: Quadrun<br />
</gallery><br />
<br />
=Some Free ROMs=<br />
* [http://usfiles.brothersoft.com/games/emulator/atari/River_Raid.zip River Raid]<br />
* [http://roms.freeroms.com/atari_roms/ateam.zip A-Team]<br />
* [http://roms.freeroms.com/atari_roms/hero.zip H.E.R.O.]<br />
<br />
=Feature Requests/TODO=<br />
<br />
=Known issues=<br />
* Stella crashes if you switch from portrait mode (the default) to landscape mode. Open bug reported to stella maintainer (debilater)<br />
* taking screenshots with the palm (orange+@+p) produces empty images<br />
* if you put stella into the background, the command menu appears<br />
<br />
=Changelog=<br />
* '''0.0.1'''<br />
** Initial version (stella 3.0 stable)<br />
<br />
}}</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Application:Stella&diff=9009Application:Stella2010-02-09T23:16:28Z<p>Debilater: </p>
<hr />
<div>[[Category:SDL]]<br />
<br />
{{application<br />
|name=Stella<br />
|type=webOS<br />
|version=Version: Alpha 0.0.1 <br />(10. Feb 2010)<br />
|tag=Games<br />
|screenshot=Romlauncher.png<br />
|description=<br />
<br />
=Stella Atari 2600 VCS Emulator 3.0=<br />
[[Image:Stella_icon.png]]Stella is a multi-platform Atari 2600 VCS emulator released under the GNU General Public License (GPL).<br />
<br />
=Credit=<br />
Ported by [http://www.daemon.de/PalmPre Thomas Linden (debilater)] February 2010.<br />
<br />
=Thanks=<br />
First Thanks goes to my beloved wife Leo, without her patience and support I couldn't ever make this happen! Thanks goes to the Stella development team for this awesome emulator! Thanks to the webos-internals team for their hard work on [[WebOS_Internals_PDK|WIDK]]!<br />
<br />
=Donate=<br />
As you might assume, porting software to the palm pre webOS platform is a lot of work, so please consider to [[WebOS_Internals:Site_support|donate]] to the project so that the work can be continued in the future. Thanks!<br />
<br />
=License=<br />
All source is under the GPL license.<br />
The original source code is available [http://stella.sourceforge.net/downloads.php here]<br /><br />
And the latest "Stella Atari 2600 VCS Emulator" for webOS source is available on git [http://git.webos-internals.org/?p=games/stella.git here] <br /><br />
<br />
== Installing VBA ==<br />
Install [[Preware]], and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "stella" (no quotes). Stella should show up. If not, make sure your feeds are up to date. Click on Stella and then click install. You will probably have to install other services as well (it will tell you if you do).<br />
<br/><br />
<br />
Now you are ready to add ROMs(games)!<br />
<br />
==Adding ROMS==<br />
We aren't going to discuss how to get ROMs here but we will tell you how to transfer them to your Pre. (there are some links to free roms on the bottom).<br />
<br />
You may use .a26, .bin, .rom, gz, or .zip Atari 2600 ROM files.<br />
<br />
Connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", "ringtones", and most importantly, a "stella" folder. Click on that and therein the "roms" folder. Copy the ROMs from your computer and move them here. Just put the files there, do not create subdirectories.<br />
<br />
==Controls==<br />
If you have installed some ROM files, start Stella, you will see a list of games available. Select one by tapping on it and tap on the "select" button in the bottom left corner - the game starts. You might also enter some letters, the cursor will then jump to the possition in the list (if there is a match).<br />
<br />
Here is the default Keymapping coming with Stella for webOS:<br />
<br />
* up - w<br />
* down - s<br />
* left - a<br />
* right - d<br />
* jump - space (originally called fire1 too)<br />
* fire2 - f<br />
* fire3 - g<br />
* select - enter<br />
* reset - q<br />
* save - shift<br />
* load - l<br />
* take screenshot - p<br />
* options-menu - delete<br />
* command-menu - c<br />
* close popups - swipe right-to-left (probably ESC)<br />
<br />
==The most important things to know==<br />
<br />
* ''start game'': press space bar<br />
* ''move around'': use w,s,a,d keys (see above)<br />
* ''fire/jump'': press spacebar<br />
* ''switch to landscape mode'': press Delete on keyboard => tap "UI Settings" => tap "Fullscreen" => select "off" => tap button "Ok"<br />
* ''modify keymappings'': press Delete on keyboard => tap "Input Settings" => select a function (current mapping will be displayed below!) => tap "Map" => press the new key => tap "Ok"<br />
* ''take screenshot'': press "p", screenshots will be saved to "/media/internals/stella/screenshots/"<br />
* ''exit current game/return to ROM Launcher'': press "c" key => tap "Exit Game"<br />
* ''exit Stella'': throw it away OR tap "Quit" in ROM Launcher<br />
<br />
=User Guide=<br />
Please don't miss the complete [http://stella.sourceforge.net/docs/index.html Original Stella Userguide]. It will answer all the questions.<br />
<br />
=F.A.Q.=<br />
<br />
==I've bricked my config - stella doesn't start anymore or is unusable!==<br />
Delete the file /media/internals/stella/config/stellarc and start Stella again, it will create a new config with the builtin default parameters<br />
<br />
==Re-Mapping Keys in the Input Preferences Dialog is a nightmare, is there any better way to do it?==<br />
Unfortunately: nope. You might edit the config file but the keymapping format is not human understandable. Sorry!<br />
<br />
==Stella crashed and my phone boots, help!==<br />
From time to time the app crashes and under some rare conditions it takes Luna (webOS GUI Manager) with it. Don't worry, at least it won't destroy anything.<br />
<br />
==Where can I get further help?==<br />
Post a message to the Stella Forum Thread: ''FIXME''<br />
<br />
=Screenshots=<br />
<gallery><br />
Image:Romlauncher.png|ROM Launcher<br />
Image:Stella_About.png|About dialog<br />
Image:Stella_Settings.png|Settings menu<br />
Image:Crazy_Climber_(1982)_(Atari).png|Game: Crazy Climber<br />
Image:Demon_Attack_(1982)_(Imagic).png|Game: Demon Attack<br />
Image:Mario_Bros._(1983)_(Atari).png|Game: Mario Bros<br />
Image:SwordQuest_-_WaterWorld_(1983)_(Atari).png|Game: Sword Quest<br />
Image:Quadrun_(1983)_(Atari)_(Prototype).png|Game: Quadrun<br />
</gallery><br />
<br />
=Some Free ROMs=<br />
* [http://usfiles.brothersoft.com/games/emulator/atari/River_Raid.zip River Raid]<br />
* [http://roms.freeroms.com/atari_roms/ateam.zip A-Team]<br />
* [http://roms.freeroms.com/atari_roms/hero.zip H.E.R.O.]<br />
<br />
=Feature Requests/TODO=<br />
<br />
=Known issues=<br />
* Stella crashes if you switch from portrait mode (the default) to landscape mode. Open bug reported to stella maintainer (debilater)<br />
* taking screenshots with the palm (orange+@+p) produces empty images<br />
* if you put stella into the background, the command menu appears<br />
<br />
=Changelog=<br />
* '''0.0.1'''<br />
** Initial version (stella 3.0 stable)<br />
<br />
}}</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Portal:Linux_Applications&diff=9008Portal:Linux Applications2010-02-09T23:12:51Z<p>Debilater: </p>
<hr />
<div>__notoc__<br />
{{reorganize|This page needs to be reorganized still.}}<br />
{{portal-header<br />
|The Pre runs a very standard Linux on a commonly available processor. Very soon after access was achieved to the Linux, the Optware team made the entire catalog of Optware packages available on the pre. <br />
<br />
More about the Optware project here: [http://www.nslu2-linux.org/wiki/Optware/Packages Optware Packages].<br />
<br />
You can view a list of available packages here: [http://ipkg.nslu2-linux.org/feeds/optware/cs08q1armel/cross/unstable/ List of Packages].<br />
<br />
The community has been busy porting other applications to the Pre. Some of those are listed, and have pages for them below.<br />
}}<br />
{{portal-three-columns<br />
|column1=<br />
* [[Portal:Linux_Applications_All|All]]<br />
* [[Portal:Linux_Applications_Business|Business]]<br />
* [[Portal:Linux_Applications_Communications|Communications]]<br />
* [[Portal:Linux_Applications_Entertainment|Entertainment]]<br />
<br />
|column2=<br />
* [[Portal:Linux_Applications_Food|Food]]<br />
* [[Portal:Linux_Applications_Games|Games]]<br />
* [[Portal:Linux_Applications_Lifestyle|Lifestyle]]<br />
* [[Portal:Linux_Applications_News|News]]<br />
<br />
|column3=<br />
* [[Portal:Linux_Applications_Social Networking|Social Networking]]<br />
* [[Portal:Linux_Applications_Tutorial|Tutorial]]<br />
* [[Portal:Linux_Applications_Utilities|Utilities]]<br />
* [[Portal:Linux_Applications_Productivity|Productivity]]<br />
}}<br />
{{portal-two-columns<br />
|column1=<br />
== Application Tutorials ==<br />
<br />
'''[[Portal:Accessing Linux|Follow the Accessing Linux Article First]]'''<br />
* [[Ad-Hoc_Networking|Ad-Hoc Networking]]<br />
* [[Ajaxterm]]<br />
* [[Apache]]<br />
* [[Colorful_Bash_Prompt|Colorful Bash Prompt]]<br />
* [[Diff]]<br />
* [[Tutorials_Linux_DDNS_for_EVDO|Dynamic DNS for EVDO]]<br />
* [[DFBTerm DirectFB Terminal Emulator|DFBTerm DirectFB Terminal Emulator]] <br />
* [[Graphical Shell with WebShell|Graphical Shell with WebShell]] <br />
* [[GUI Text Editors|GUI Text Editors]] <br />
* [[HamachiVPN|HamachiVPN]] <br />
* [[How To Use "ls" In Color|How To Use "ls" In Color]] <br />
* [[Linux Tutorial Irssi|Linux Tutorial Irssi]]<br />
* [[Linux Tutorial Snownews|Linux Tutorial Snownews]]<br />
* [[Lighttpd|Lighttpd ]] <br />
* [[OpenVPN for Palm Pre|OpenVPN for Palm Pre]] <br />
* [[Tutorials_Linux_opt_on_loopback|/opt on loopback image on /media/internal]]<br />
* [[PalmVNC Terminal|PalmVNC Terminal]] <br />
* [[QEMU|QEMU]] <br />
* [[QEMU webOS Emulation|QEMU webOS Emulation]] <br />
* [[Running webOS in QEMU|Running webOS in QEMU]] <br />
* [[Replace "vi" with Fullscreen Text Editor "joe" or "nano"|Replace "vi" with Fullscreen Text Editor "joe" or "nano"]] <br />
* [[rTorrent]] <br />
* [[Setup Bash|Setup Bash]] <br />
* [[Samba Access|Samba Access]] <br />
* [[VNC (Virtual Network Computing)|VNC (Virtual Network Computing)]] <br />
* [[Vala Terminal|Vala Terminal]]<br />
* [[Application:VBA|VisualBoyAdvance]] an emulator of the Game Boy, Game Boy Color, and Game Boy Advance <br />
* [[Application:Stella|Stella]] Atari 2600 VCS Emulator<br />
* [[Wireless Music Sync with Amarok 1.4|Wireless Music Sync with Amarok 1.4]]<br />
* [[Application:Gnuboy|Gameboy emulator gnuboy on the Pre]]<br />
* [[SetupSquidTransparentProxy|Setup Squid transparent proxy]]<br />
* [[NES and GameBoy Emulators|NES and Gameboy Emulators Simple Setup]]<br />
<br />
== Want to write a tutorial and Add it? ==<br />
<br />
Just name the tutorial with<br />
<br />
"Tutorials Linux " + name<br />
<br />
Ex: Tutorials_Linux_Getting_Started<br /><br />
(spaces are the same thing as underscores)<br />
<br />
|column2=<br />
== Policies about adding Applications ==<br />
<br />
Your application can be any progress (Completed/Beta/Design Phase), just make sure you have a temporary name. For example if your application is called "Testing This":<br />
<br />
<source lang="text"><br />
{{portal-application-item<br />
|name=Asteroids<br />
|article=Asteroids<br />
|user=AWESOM-O<br />
|site=http://domain.com/asteroids/<br />
|description=This is a short description, leave screenshots<br />
and other details for the application page.<br />
<br />
}}<br />
</source><br />
<br />
<br />
Place this under the [[Portal:Linux Applications All|All Linux Application Portal]], and the category it goes under (for instance "Games" if it is a game). You can always change the applications name just make sure it is not taken and let us know on the [[Admin_Changes|Admin Changes]] page so we can delete the old application page (so others can use it).<br />
<br />
}}</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Portal:Linux_Applications&diff=9007Portal:Linux Applications2010-02-09T23:12:30Z<p>Debilater: </p>
<hr />
<div>__notoc__<br />
{{reorganize|This page needs to be reorganized still.}}<br />
{{portal-header<br />
|The Pre runs a very standard Linux on a commonly available processor. Very soon after access was achieved to the Linux, the Optware team made the entire catalog of Optware packages available on the pre. <br />
<br />
More about the Optware project here: [http://www.nslu2-linux.org/wiki/Optware/Packages Optware Packages].<br />
<br />
You can view a list of available packages here: [http://ipkg.nslu2-linux.org/feeds/optware/cs08q1armel/cross/unstable/ List of Packages].<br />
<br />
The community has been busy porting other applications to the Pre. Some of those are listed, and have pages for them below.<br />
}}<br />
{{portal-three-columns<br />
|column1=<br />
* [[Portal:Linux_Applications_All|All]]<br />
* [[Portal:Linux_Applications_Business|Business]]<br />
* [[Portal:Linux_Applications_Communications|Communications]]<br />
* [[Portal:Linux_Applications_Entertainment|Entertainment]]<br />
<br />
|column2=<br />
* [[Portal:Linux_Applications_Food|Food]]<br />
* [[Portal:Linux_Applications_Games|Games]]<br />
* [[Portal:Linux_Applications_Lifestyle|Lifestyle]]<br />
* [[Portal:Linux_Applications_News|News]]<br />
<br />
|column3=<br />
* [[Portal:Linux_Applications_Social Networking|Social Networking]]<br />
* [[Portal:Linux_Applications_Tutorial|Tutorial]]<br />
* [[Portal:Linux_Applications_Utilities|Utilities]]<br />
* [[Portal:Linux_Applications_Productivity|Productivity]]<br />
}}<br />
{{portal-two-columns<br />
|column1=<br />
== Application Tutorials ==<br />
<br />
'''[[Portal:Accessing Linux|Follow the Accessing Linux Article First]]'''<br />
* [[Ad-Hoc_Networking|Ad-Hoc Networking]]<br />
* [[Ajaxterm]]<br />
* [[Apache]]<br />
* [[Colorful_Bash_Prompt|Colorful Bash Prompt]]<br />
* [[Diff]]<br />
* [[Tutorials_Linux_DDNS_for_EVDO|Dynamic DNS for EVDO]]<br />
* [[DFBTerm DirectFB Terminal Emulator|DFBTerm DirectFB Terminal Emulator]] <br />
* [[Graphical Shell with WebShell|Graphical Shell with WebShell]] <br />
* [[GUI Text Editors|GUI Text Editors]] <br />
* [[HamachiVPN|HamachiVPN]] <br />
* [[How To Use "ls" In Color|How To Use "ls" In Color]] <br />
* [[Linux Tutorial Irssi|Linux Tutorial Irssi]]<br />
* [[Linux Tutorial Snownews|Linux Tutorial Snownews]]<br />
* [[Lighttpd|Lighttpd ]] <br />
* [[OpenVPN for Palm Pre|OpenVPN for Palm Pre]] <br />
* [[Tutorials_Linux_opt_on_loopback|/opt on loopback image on /media/internal]]<br />
* [[PalmVNC Terminal|PalmVNC Terminal]] <br />
* [[QEMU|QEMU]] <br />
* [[QEMU webOS Emulation|QEMU webOS Emulation]] <br />
* [[Running webOS in QEMU|Running webOS in QEMU]] <br />
* [[Replace "vi" with Fullscreen Text Editor "joe" or "nano"|Replace "vi" with Fullscreen Text Editor "joe" or "nano"]] <br />
* [[rTorrent]] <br />
* [[Setup Bash|Setup Bash]] <br />
* [[Samba Access|Samba Access]] <br />
* [[VNC (Virtual Network Computing)|VNC (Virtual Network Computing)]] <br />
* [[Vala Terminal|Vala Terminal]]<br />
* [[Application:VBA|VisualBoyAdvance]] an emulator of the Game Boy, Game Boy Color, and Game Boy Advance <br />
* [[Application:Stella|Stella]]Atari 2600 VCS Emulator<br />
* [[Wireless Music Sync with Amarok 1.4|Wireless Music Sync with Amarok 1.4]]<br />
* [[Application:Gnuboy|Gameboy emulator gnuboy on the Pre]]<br />
* [[SetupSquidTransparentProxy|Setup Squid transparent proxy]]<br />
* [[NES and GameBoy Emulators|NES and Gameboy Emulators Simple Setup]]<br />
<br />
== Want to write a tutorial and Add it? ==<br />
<br />
Just name the tutorial with<br />
<br />
"Tutorials Linux " + name<br />
<br />
Ex: Tutorials_Linux_Getting_Started<br /><br />
(spaces are the same thing as underscores)<br />
<br />
|column2=<br />
== Policies about adding Applications ==<br />
<br />
Your application can be any progress (Completed/Beta/Design Phase), just make sure you have a temporary name. For example if your application is called "Testing This":<br />
<br />
<source lang="text"><br />
{{portal-application-item<br />
|name=Asteroids<br />
|article=Asteroids<br />
|user=AWESOM-O<br />
|site=http://domain.com/asteroids/<br />
|description=This is a short description, leave screenshots<br />
and other details for the application page.<br />
<br />
}}<br />
</source><br />
<br />
<br />
Place this under the [[Portal:Linux Applications All|All Linux Application Portal]], and the category it goes under (for instance "Games" if it is a game). You can always change the applications name just make sure it is not taken and let us know on the [[Admin_Changes|Admin Changes]] page so we can delete the old application page (so others can use it).<br />
<br />
}}</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Application:Stella&diff=9006Application:Stella2010-02-09T23:11:26Z<p>Debilater: </p>
<hr />
<div>[[Category:SDL]]<br />
<br />
{{application<br />
|name=Stella<br />
|type=webOS<br />
|version=Version: Alpha 0.0.1 <br />(10. Feb 2010)<br />
|tag=Utilities<br />
|screenshot=Romlauncher.png<br />
|description=<br />
<br />
=Stella Atari 2600 VCS Emulator 3.0=<br />
[[Image:Stella_icon.png]]Stella is a multi-platform Atari 2600 VCS emulator released under the GNU General Public License (GPL).<br />
<br />
=Credit=<br />
Ported by [http://www.daemon.de/PalmPre Thomas Linden (debilater)] February 2010.<br />
<br />
=Thanks=<br />
First Thanks goes to my beloved wife Leo, without her patience and support I couldn't ever make this happen! Thanks goes to the Stella development team for this awesome emulator! Thanks to the webos-internals team for their hard work on [[WebOS_Internals_PDK|WIDK]]!<br />
<br />
=Donate=<br />
As you might assume, porting software to the palm pre webOS platform is a lot of work, so please consider to [[WebOS_Internals:Site_support|donate]] to the project so that the work can be continued in the future. Thanks!<br />
<br />
=License=<br />
All source is under the GPL license.<br />
The original source code is available [http://stella.sourceforge.net/downloads.php here]<br /><br />
And the latest "Stella Atari 2600 VCS Emulator" for webOS source is available on git [http://git.webos-internals.org/?p=games/stella.git here] <br /><br />
<br />
== Installing VBA ==<br />
Install [[Preware]], and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "stella" (no quotes). Stella should show up. If not, make sure your feeds are up to date. Click on Stella and then click install. You will probably have to install other services as well (it will tell you if you do).<br />
<br/><br />
<br />
Now you are ready to add ROMs(games)!<br />
<br />
==Adding ROMS==<br />
We aren't going to discuss how to get ROMs here but we will tell you how to transfer them to your Pre. (there are some links to free roms on the bottom).<br />
<br />
You may use .a26, .bin, .rom, gz, or .zip Atari 2600 ROM files.<br />
<br />
Connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", "ringtones", and most importantly, a "stella" folder. Click on that and therein the "roms" folder. Copy the ROMs from your computer and move them here. Just put the files there, do not create subdirectories.<br />
<br />
==Controls==<br />
If you have installed some ROM files, start Stella, you will see a list of games available. Select one by tapping on it and tap on the "select" button in the bottom left corner - the game starts. You might also enter some letters, the cursor will then jump to the possition in the list (if there is a match).<br />
<br />
Here is the default Keymapping coming with Stella for webOS:<br />
<br />
* up - w<br />
* down - s<br />
* left - a<br />
* right - d<br />
* jump - space (originally called fire1 too)<br />
* fire2 - f<br />
* fire3 - g<br />
* select - enter<br />
* reset - q<br />
* save - shift<br />
* load - l<br />
* take screenshot - p<br />
* options-menu - delete<br />
* command-menu - c<br />
* close popups - swipe right-to-left (probably ESC)<br />
<br />
==The most important things to know==<br />
<br />
* ''start game'': press space bar<br />
* ''move around'': use w,s,a,d keys (see above)<br />
* ''fire/jump'': press spacebar<br />
* ''switch to landscape mode'': press Delete on keyboard => tap "UI Settings" => tap "Fullscreen" => select "off" => tap button "Ok"<br />
* ''modify keymappings'': press Delete on keyboard => tap "Input Settings" => select a function (current mapping will be displayed below!) => tap "Map" => press the new key => tap "Ok"<br />
* ''take screenshot'': press "p", screenshots will be saved to "/media/internals/stella/screenshots/"<br />
* ''exit current game/return to ROM Launcher'': press "c" key => tap "Exit Game"<br />
* ''exit Stella'': throw it away OR tap "Quit" in ROM Launcher<br />
<br />
=User Guide=<br />
Please don't miss the complete [http://stella.sourceforge.net/docs/index.html Original Stella Userguide]. It will answer all the questions.<br />
<br />
=F.A.Q.=<br />
<br />
==I've bricked my config - stella doesn't start anymore or is unusable!==<br />
Delete the file /media/internals/stella/config/stellarc and start Stella again, it will create a new config with the builtin default parameters<br />
<br />
==Re-Mapping Keys in the Input Preferences Dialog is a nightmare, is there any better way to do it?==<br />
Unfortunately: nope. You might edit the config file but the keymapping format is not human understandable. Sorry!<br />
<br />
==Stella crashed and my phone boots, help!==<br />
From time to time the app crashes and under some rare conditions it takes Luna (webOS GUI Manager) with it. Don't worry, at least it won't destroy anything.<br />
<br />
==Where can I get further help?==<br />
Post a message to the Stella Forum Thread: ''FIXME''<br />
<br />
=Screenshots=<br />
<gallery><br />
Image:Romlauncher.png|ROM Launcher<br />
Image:Stella_About.png|About dialog<br />
Image:Stella_Settings.png|Settings menu<br />
Image:Crazy_Climber_(1982)_(Atari).png|Game: Crazy Climber<br />
Image:Demon_Attack_(1982)_(Imagic).png|Game: Demon Attack<br />
Image:Mario_Bros._(1983)_(Atari).png|Game: Mario Bros<br />
Image:SwordQuest_-_WaterWorld_(1983)_(Atari).png|Game: Sword Quest<br />
Image:Quadrun_(1983)_(Atari)_(Prototype).png|Game: Quadrun<br />
</gallery><br />
<br />
=Some Free ROMs=<br />
* [http://usfiles.brothersoft.com/games/emulator/atari/River_Raid.zip River Raid]<br />
* [http://roms.freeroms.com/atari_roms/ateam.zip A-Team]<br />
* [http://roms.freeroms.com/atari_roms/hero.zip H.E.R.O.]<br />
<br />
=Feature Requests/TODO=<br />
<br />
=Known issues=<br />
* Stella crashes if you switch from portrait mode (the default) to landscape mode. Open bug reported to stella maintainer (debilater)<br />
* taking screenshots with the palm (orange+@+p) produces empty images<br />
* if you put stella into the background, the command menu appears<br />
<br />
=Changelog=<br />
* '''0.0.1'''<br />
** Initial version (stella 3.0 stable)<br />
<br />
}}</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Application:Stella&diff=9005Application:Stella2010-02-09T23:10:56Z<p>Debilater: </p>
<hr />
<div>[[Category:SDL]]<br />
<br />
{{application<br />
|name=Stella<br />
|type=webOS<br />
|version=Version: Alpha 0.0.1 <br />(10. Feb 2010)<br />
|tag=Utilities<br />
|screenshot=Romlauncher.png<br />
|description=<br />
<br />
== Summary == <br />
{{icon|Stella_icon.png|float:right;}}<br />
<br />
=Stella Atari 2600 VCS Emulator 3.0=<br />
[[Image:Stella_icon.png]]Stella is a multi-platform Atari 2600 VCS emulator released under the GNU General Public License (GPL).<br />
<br />
=Credit=<br />
Ported by [http://www.daemon.de/PalmPre Thomas Linden (debilater)] February 2010.<br />
<br />
=Thanks=<br />
First Thanks goes to my beloved wife Leo, without her patience and support I couldn't ever make this happen! Thanks goes to the Stella development team for this awesome emulator! Thanks to the webos-internals team for their hard work on [[WebOS_Internals_PDK|WIDK]]!<br />
<br />
=Donate=<br />
As you might assume, porting software to the palm pre webOS platform is a lot of work, so please consider to [[WebOS_Internals:Site_support|donate]] to the project so that the work can be continued in the future. Thanks!<br />
<br />
=License=<br />
All source is under the GPL license.<br />
The original source code is available [http://stella.sourceforge.net/downloads.php here]<br /><br />
And the latest "Stella Atari 2600 VCS Emulator" for webOS source is available on git [http://git.webos-internals.org/?p=games/stella.git here] <br /><br />
<br />
== Installing VBA ==<br />
Install [[Preware]], and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "stella" (no quotes). Stella should show up. If not, make sure your feeds are up to date. Click on Stella and then click install. You will probably have to install other services as well (it will tell you if you do).<br />
<br/><br />
<br />
Now you are ready to add ROMs(games)!<br />
<br />
==Adding ROMS==<br />
We aren't going to discuss how to get ROMs here but we will tell you how to transfer them to your Pre. (there are some links to free roms on the bottom).<br />
<br />
You may use .a26, .bin, .rom, gz, or .zip Atari 2600 ROM files.<br />
<br />
Connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", "ringtones", and most importantly, a "stella" folder. Click on that and therein the "roms" folder. Copy the ROMs from your computer and move them here. Just put the files there, do not create subdirectories.<br />
<br />
==Controls==<br />
If you have installed some ROM files, start Stella, you will see a list of games available. Select one by tapping on it and tap on the "select" button in the bottom left corner - the game starts. You might also enter some letters, the cursor will then jump to the possition in the list (if there is a match).<br />
<br />
Here is the default Keymapping coming with Stella for webOS:<br />
<br />
* up - w<br />
* down - s<br />
* left - a<br />
* right - d<br />
* jump - space (originally called fire1 too)<br />
* fire2 - f<br />
* fire3 - g<br />
* select - enter<br />
* reset - q<br />
* save - shift<br />
* load - l<br />
* take screenshot - p<br />
* options-menu - delete<br />
* command-menu - c<br />
* close popups - swipe right-to-left (probably ESC)<br />
<br />
==The most important things to know==<br />
<br />
* ''start game'': press space bar<br />
* ''move around'': use w,s,a,d keys (see above)<br />
* ''fire/jump'': press spacebar<br />
* ''switch to landscape mode'': press Delete on keyboard => tap "UI Settings" => tap "Fullscreen" => select "off" => tap button "Ok"<br />
* ''modify keymappings'': press Delete on keyboard => tap "Input Settings" => select a function (current mapping will be displayed below!) => tap "Map" => press the new key => tap "Ok"<br />
* ''take screenshot'': press "p", screenshots will be saved to "/media/internals/stella/screenshots/"<br />
* ''exit current game/return to ROM Launcher'': press "c" key => tap "Exit Game"<br />
* ''exit Stella'': throw it away OR tap "Quit" in ROM Launcher<br />
<br />
=User Guide=<br />
Please don't miss the complete [http://stella.sourceforge.net/docs/index.html Original Stella Userguide]. It will answer all the questions.<br />
<br />
=F.A.Q.=<br />
<br />
==I've bricked my config - stella doesn't start anymore or is unusable!==<br />
Delete the file /media/internals/stella/config/stellarc and start Stella again, it will create a new config with the builtin default parameters<br />
<br />
==Re-Mapping Keys in the Input Preferences Dialog is a nightmare, is there any better way to do it?==<br />
Unfortunately: nope. You might edit the config file but the keymapping format is not human understandable. Sorry!<br />
<br />
==Stella crashed and my phone boots, help!==<br />
From time to time the app crashes and under some rare conditions it takes Luna (webOS GUI Manager) with it. Don't worry, at least it won't destroy anything.<br />
<br />
==Where can I get further help?==<br />
Post a message to the Stella Forum Thread: ''FIXME''<br />
<br />
=Screenshots=<br />
<gallery><br />
Image:Romlauncher.png|ROM Launcher<br />
Image:Stella_About.png|About dialog<br />
Image:Stella_Settings.png|Settings menu<br />
Image:Crazy_Climber_(1982)_(Atari).png|Game: Crazy Climber<br />
Image:Demon_Attack_(1982)_(Imagic).png|Game: Demon Attack<br />
Image:Mario_Bros._(1983)_(Atari).png|Game: Mario Bros<br />
Image:SwordQuest_-_WaterWorld_(1983)_(Atari).png|Game: Sword Quest<br />
Image:Quadrun_(1983)_(Atari)_(Prototype).png|Game: Quadrun<br />
</gallery><br />
<br />
=Some Free ROMs=<br />
* [http://usfiles.brothersoft.com/games/emulator/atari/River_Raid.zip River Raid]<br />
* [http://roms.freeroms.com/atari_roms/ateam.zip A-Team]<br />
* [http://roms.freeroms.com/atari_roms/hero.zip H.E.R.O.]<br />
<br />
=Feature Requests/TODO=<br />
<br />
=Known issues=<br />
* Stella crashes if you switch from portrait mode (the default) to landscape mode. Open bug reported to stella maintainer (debilater)<br />
* taking screenshots with the palm (orange+@+p) produces empty images<br />
* if you put stella into the background, the command menu appears<br />
<br />
=Changelog=<br />
* '''0.0.1'''<br />
** Initial version (stella 3.0 stable)<br />
<br />
}}</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Portal:Linux_Applications_All&diff=9004Portal:Linux Applications All2010-02-09T23:05:21Z<p>Debilater: added stella</p>
<hr />
<div>__notoc__<!-- NOTE NOTE NOTE NOT leave this comment at the top of the page. <br />
<br />
copy this template and fill it in for each applicaton: <br />
<br />
{{portal-application-item<br />
|name=<br />
|site=<br />
|user=<br />
|article=<br />
|category=<br />
|description=<br />
}}<br />
}}<br />
<br />
-->{{portal-application-type<br />
|type=Linux<br />
|tag=All<br />
|title=All applications are listed below no matter what category they fall under.<br />
|list=<br />
<br />
{{portal-application-item<br />
|name=Doom<br />
|site=http://google.com/<br />
|user=Unknown<br />
|article=Doom<br />
|category=Games<br />
|description=Port of Doom by ID Software.<br />
}}<br />
<br />
{{portal-application-item<br />
|name=F5VPN<br />
|site=http://google.com/<br />
|user=Unknown<br />
|article=F5VPN<br />
|category=Communication<br />
|description=Empty<br />
}}<br />
<br />
{{portal-application-item<br />
|name=sdlVNC<br />
|site=http://google.com/<br />
|user=Unknown<br />
|article=sdlVNC<br />
|category=Communication<br />
|description=VNC (SDL) client<br />
}}<br />
<br />
{{portal-application-item<br />
|name=Stella<br />
|site=http://stella.sourceforge.net/<br />
|user=debilater<br />
|article=Stella<br />
|category=Games<br />
|description=Atari 2600 VCS Emulator<br />
}}<br />
}}</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Application:Stella&diff=9003Application:Stella2010-02-09T23:01:40Z<p>Debilater: /* Screenshots */</p>
<hr />
<div>=Stella Atari 2600 VCS Emulator 3.0=<br />
[[Image:Stella_icon.png]]Stella is a multi-platform Atari 2600 VCS emulator released under the GNU General Public License (GPL).<br />
<br />
=Credit=<br />
Ported by [http://www.daemon.de/PalmPre Thomas Linden (debilater)] February 2010.<br />
<br />
=Thanks=<br />
First Thanks goes to my beloved wife Leo, without her patience and support I couldn't ever make this happen! Thanks goes to the Stella development team for this awesome emulator! Thanks to the webos-internals team for their hard work on [[WebOS_Internals_PDK|WIDK]]!<br />
<br />
=Donate=<br />
As you might assume, porting software to the palm pre webOS platform is a lot of work, so please consider to [[WebOS_Internals:Site_support|donate]] to the project so that the work can be continued in the future. Thanks!<br />
<br />
=License=<br />
All source is under the GPL license.<br />
The original source code is available [http://stella.sourceforge.net/downloads.php here]<br /><br />
And the latest "Stella Atari 2600 VCS Emulator" for webOS source is available on git [http://git.webos-internals.org/?p=games/stella.git here] <br /><br />
<br />
== Installing VBA ==<br />
Install [[Preware]], and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "stella" (no quotes). Stella should show up. If not, make sure your feeds are up to date. Click on Stella and then click install. You will probably have to install other services as well (it will tell you if you do).<br />
<br/><br />
<br />
Now you are ready to add ROMs(games)!<br />
<br />
==Adding ROMS==<br />
We aren't going to discuss how to get ROMs here but we will tell you how to transfer them to your Pre. (there are some links to free roms on the bottom).<br />
<br />
You may use .a26, .bin, .rom, gz, or .zip Atari 2600 ROM files.<br />
<br />
Connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", "ringtones", and most importantly, a "stella" folder. Click on that and therein the "roms" folder. Copy the ROMs from your computer and move them here. Just put the files there, do not create subdirectories.<br />
<br />
==Controls==<br />
If you have installed some ROM files, start Stella, you will see a list of games available. Select one by tapping on it and tap on the "select" button in the bottom left corner - the game starts. You might also enter some letters, the cursor will then jump to the possition in the list (if there is a match).<br />
<br />
Here is the default Keymapping coming with Stella for webOS:<br />
<br />
* up - w<br />
* down - s<br />
* left - a<br />
* right - d<br />
* jump - space (originally called fire1 too)<br />
* fire2 - f<br />
* fire3 - g<br />
* select - enter<br />
* reset - q<br />
* save - shift<br />
* load - l<br />
* take screenshot - p<br />
* options-menu - delete<br />
* command-menu - c<br />
* close popups - swipe right-to-left (probably ESC)<br />
<br />
==The most important things to know==<br />
<br />
* ''start game'': press space bar<br />
* ''move around'': use w,s,a,d keys (see above)<br />
* ''fire/jump'': press spacebar<br />
* ''switch to landscape mode'': press Delete on keyboard => tap "UI Settings" => tap "Fullscreen" => select "off" => tap button "Ok"<br />
* ''modify keymappings'': press Delete on keyboard => tap "Input Settings" => select a function (current mapping will be displayed below!) => tap "Map" => press the new key => tap "Ok"<br />
* ''take screenshot'': press "p", screenshots will be saved to "/media/internals/stella/screenshots/"<br />
* ''exit current game/return to ROM Launcher'': press "c" key => tap "Exit Game"<br />
* ''exit Stella'': throw it away OR tap "Quit" in ROM Launcher<br />
<br />
=User Guide=<br />
Please don't miss the complete [http://stella.sourceforge.net/docs/index.html Original Stella Userguide]. It will answer all the questions.<br />
<br />
=F.A.Q.=<br />
<br />
==I've bricked my config - stella doesn't start anymore or is unusable!==<br />
Delete the file /media/internals/stella/config/stellarc and start Stella again, it will create a new config with the builtin default parameters<br />
<br />
==Re-Mapping Keys in the Input Preferences Dialog is a nightmare, is there any better way to do it?==<br />
Unfortunately: nope. You might edit the config file but the keymapping format is not human understandable. Sorry!<br />
<br />
==Stella crashed and my phone boots, help!==<br />
From time to time the app crashes and under some rare conditions it takes Luna (webOS GUI Manager) with it. Don't worry, at least it won't destroy anything.<br />
<br />
==Where can I get further help?==<br />
Post a message to the Stella Forum Thread: ''FIXME''<br />
<br />
=Screenshots=<br />
<gallery><br />
Image:Romlauncher.png|ROM Launcher<br />
Image:Stella_About.png|About dialog<br />
Image:Stella_Settings.png|Settings menu<br />
Image:Crazy_Climber_(1982)_(Atari).png|Game: Crazy Climber<br />
Image:Demon_Attack_(1982)_(Imagic).png|Game: Demon Attack<br />
Image:Mario_Bros._(1983)_(Atari).png|Game: Mario Bros<br />
Image:SwordQuest_-_WaterWorld_(1983)_(Atari).png|Game: Sword Quest<br />
Image:Quadrun_(1983)_(Atari)_(Prototype).png|Game: Quadrun<br />
</gallery><br />
<br />
=Some Free ROMs=<br />
* [http://usfiles.brothersoft.com/games/emulator/atari/River_Raid.zip River Raid]<br />
* [http://roms.freeroms.com/atari_roms/ateam.zip A-Team]<br />
* [http://roms.freeroms.com/atari_roms/hero.zip H.E.R.O.]<br />
<br />
=Feature Requests/TODO=<br />
<br />
=Known issues=<br />
* Stella crashes if you switch from portrait mode (the default) to landscape mode. Open bug reported to stella maintainer (debilater)<br />
* taking screenshots with the palm (orange+@+p) produces empty images<br />
* if you put stella into the background, the command menu appears<br />
<br />
=Changelog=<br />
* '''0.0.1'''<br />
** Initial version (stella 3.0 stable)</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Application:Stella&diff=9002Application:Stella2010-02-09T22:54:42Z<p>Debilater: </p>
<hr />
<div>=Stella Atari 2600 VCS Emulator 3.0=<br />
[[Image:Stella_icon.png]]Stella is a multi-platform Atari 2600 VCS emulator released under the GNU General Public License (GPL).<br />
<br />
=Credit=<br />
Ported by [http://www.daemon.de/PalmPre Thomas Linden (debilater)] February 2010.<br />
<br />
=Thanks=<br />
First Thanks goes to my beloved wife Leo, without her patience and support I couldn't ever make this happen! Thanks goes to the Stella development team for this awesome emulator! Thanks to the webos-internals team for their hard work on [[WebOS_Internals_PDK|WIDK]]!<br />
<br />
=Donate=<br />
As you might assume, porting software to the palm pre webOS platform is a lot of work, so please consider to [[WebOS_Internals:Site_support|donate]] to the project so that the work can be continued in the future. Thanks!<br />
<br />
=License=<br />
All source is under the GPL license.<br />
The original source code is available [http://stella.sourceforge.net/downloads.php here]<br /><br />
And the latest "Stella Atari 2600 VCS Emulator" for webOS source is available on git [http://git.webos-internals.org/?p=games/stella.git here] <br /><br />
<br />
== Installing VBA ==<br />
Install [[Preware]], and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "stella" (no quotes). Stella should show up. If not, make sure your feeds are up to date. Click on Stella and then click install. You will probably have to install other services as well (it will tell you if you do).<br />
<br/><br />
<br />
Now you are ready to add ROMs(games)!<br />
<br />
==Adding ROMS==<br />
We aren't going to discuss how to get ROMs here but we will tell you how to transfer them to your Pre. (there are some links to free roms on the bottom).<br />
<br />
You may use .a26, .bin, .rom, gz, or .zip Atari 2600 ROM files.<br />
<br />
Connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", "ringtones", and most importantly, a "stella" folder. Click on that and therein the "roms" folder. Copy the ROMs from your computer and move them here. Just put the files there, do not create subdirectories.<br />
<br />
==Controls==<br />
If you have installed some ROM files, start Stella, you will see a list of games available. Select one by tapping on it and tap on the "select" button in the bottom left corner - the game starts. You might also enter some letters, the cursor will then jump to the possition in the list (if there is a match).<br />
<br />
Here is the default Keymapping coming with Stella for webOS:<br />
<br />
* up - w<br />
* down - s<br />
* left - a<br />
* right - d<br />
* jump - space (originally called fire1 too)<br />
* fire2 - f<br />
* fire3 - g<br />
* select - enter<br />
* reset - q<br />
* save - shift<br />
* load - l<br />
* take screenshot - p<br />
* options-menu - delete<br />
* command-menu - c<br />
* close popups - swipe right-to-left (probably ESC)<br />
<br />
==The most important things to know==<br />
<br />
* ''start game'': press space bar<br />
* ''move around'': use w,s,a,d keys (see above)<br />
* ''fire/jump'': press spacebar<br />
* ''switch to landscape mode'': press Delete on keyboard => tap "UI Settings" => tap "Fullscreen" => select "off" => tap button "Ok"<br />
* ''modify keymappings'': press Delete on keyboard => tap "Input Settings" => select a function (current mapping will be displayed below!) => tap "Map" => press the new key => tap "Ok"<br />
* ''take screenshot'': press "p", screenshots will be saved to "/media/internals/stella/screenshots/"<br />
* ''exit current game/return to ROM Launcher'': press "c" key => tap "Exit Game"<br />
* ''exit Stella'': throw it away OR tap "Quit" in ROM Launcher<br />
<br />
=User Guide=<br />
Please don't miss the complete [http://stella.sourceforge.net/docs/index.html Original Stella Userguide]. It will answer all the questions.<br />
<br />
=F.A.Q.=<br />
<br />
==I've bricked my config - stella doesn't start anymore or is unusable!==<br />
Delete the file /media/internals/stella/config/stellarc and start Stella again, it will create a new config with the builtin default parameters<br />
<br />
==Re-Mapping Keys in the Input Preferences Dialog is a nightmare, is there any better way to do it?==<br />
Unfortunately: nope. You might edit the config file but the keymapping format is not human understandable. Sorry!<br />
<br />
==Stella crashed and my phone boots, help!==<br />
From time to time the app crashes and under some rare conditions it takes Luna (webOS GUI Manager) with it. Don't worry, at least it won't destroy anything.<br />
<br />
==Where can I get further help?==<br />
Post a message to the Stella Forum Thread: ''FIXME''<br />
<br />
=Screenshots=<br />
<gallery><br />
Image:Romlauncher.png<br />
Image:Stella_About.png<br />
Image:Stella_Settings.png<br />
Image:Crazy_Climber_(1982)_(Atari).png<br />
Image:Demon_Attack_(1982)_(Imagic).png<br />
Image:Mario_Bros._(1983)_(Atari).png<br />
Image:SwordQuest_-_WaterWorld_(1983)_(Atari).png<br />
Image:Quadrun_(1983)_(Atari)_(Prototype).png<br />
</gallery><br />
<br />
=Some Free ROMs=<br />
* [http://usfiles.brothersoft.com/games/emulator/atari/River_Raid.zip River Raid]<br />
* [http://roms.freeroms.com/atari_roms/ateam.zip A-Team]<br />
* [http://roms.freeroms.com/atari_roms/hero.zip H.E.R.O.]<br />
<br />
=Feature Requests/TODO=<br />
<br />
=Known issues=<br />
* Stella crashes if you switch from portrait mode (the default) to landscape mode. Open bug reported to stella maintainer (debilater)<br />
* taking screenshots with the palm (orange+@+p) produces empty images<br />
* if you put stella into the background, the command menu appears<br />
<br />
=Changelog=<br />
* '''0.0.1'''<br />
** Initial version (stella 3.0 stable)</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Application:Stella&diff=9001Application:Stella2010-02-09T22:33:18Z<p>Debilater: /* Screenshots */</p>
<hr />
<div>=Stella Atari 2600 VCS Emulator 3.0=<br />
[[Image:Stella_icon.png]]Stella is a multi-platform Atari 2600 VCS emulator released under the GNU General Public License (GPL).<br />
<br />
=Credit=<br />
Ported by [http://www.daemon.de/PalmPre Thomas Linden (debilater)] February 2010.<br />
<br />
=Thanks=<br />
First Thanks goes to my beloved wife Leo, without her patience and support I couldn't ever make this happen! Thanks goes to the Stella development team for this awesome emulator! Thanks to the webos-internals team for their hard work on [[WebOS_Internals_PDK|WIDK]]!<br />
<br />
=Donate=<br />
As you might assume, porting software to the palm pre webOS platform is a lot of work, so please consider to [[WebOS_Internals:Site_support|donate]] to the project so that the work can be continued in the future. Thanks!<br />
<br />
=License=<br />
All source is under the GPL license.<br />
The original source code is available [http://stella.sourceforge.net/downloads.php here]<br /><br />
And the latest "Stella Atari 2600 VCS Emulator" for webOS source is available on git [http://git.webos-internals.org/?p=games/stella.git here] <br /><br />
<br />
== Installing VBA ==<br />
Install [[Preware]], and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "stella" (no quotes). Stella should show up. If not, make sure your feeds are up to date. Click on Stella and then click install. You will probably have to install other services as well (it will tell you if you do).<br />
<br/><br />
<br />
Now you are ready to add ROMs(games)!<br />
<br />
==Adding ROMS==<br />
We aren't going to discuss how to get ROMs here but we will tell you how to transfer them to your Pre.<br />
<br />
You may use .a26, .bin, .rom, gz, or .zip Atari 2600 ROM files.<br />
<br />
Connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", "ringtones", and most importantly, a "stella" folder. Click on that and therein the "roms" folder. Copy the ROMs from your computer and move them here. Just put the files there, do not create subdirectories.<br />
<br />
==Controls==<br />
If you have installed some ROM files, start Stella, you will see a list of games available. Select one by tapping on it and tap on the "select" button in the bottom left corner - the game starts. You might also enter some letters, the cursor will then jump to the possition in the list (if there is a match).<br />
<br />
Here is the default Keymapping coming with Stella for webOS:<br />
<br />
* up - w<br />
* down - s<br />
* left - a<br />
* right - d<br />
* jump - space (originally called fire1 too)<br />
* fire2 - f<br />
* fire3 - g<br />
* select - enter<br />
* reset - q<br />
* save - shift<br />
* load - l<br />
* take screenshot - p<br />
* options-menu - delete<br />
* command-menu - c<br />
* close popups - swipe right-to-left (probably ESC)<br />
<br />
==The most important things to know==<br />
<br />
* ''start game'': press space bar<br />
* ''move around'': use w,s,a,d keys (see above)<br />
* ''fire/jump'': press spacebar<br />
* ''switch to landscape mode'': press Delete on keyboard => tap "UI Settings" => tap "Fullscreen" => select "off" => tap button "Ok"<br />
* ''modify keymappings'': press Delete on keyboard => tap "Input Settings" => select a function (current mapping will be displayed below!) => tap "Map" => press the new key => tap "Ok"<br />
* ''take screenshot'': press "p", screenshots will be saved to "/media/internals/stella/screenshots/"<br />
* ''exit current game/return to ROM Launcher'': press "c" key => tap "Exit Game"<br />
* ''exit Stella'': throw it away OR tap "Quit" in ROM Launcher<br />
<br />
==User Guide==<br />
Please don't miss the complete [http://stella.sourceforge.net/docs/index.html Original Stella Userguide]. It will answer all the questions.<br />
<br />
==F.A.Q.==<br />
<br />
===I've bricked my config - stella doesn't start anymore or is unusable!===<br />
Delete the file /media/internals/stella/config/stellarc and start Stella again, it will create a new config with the builtin default parameters<br />
<br />
===Re-Mapping Keys in the Input Preferences Dialog is a nightmare, is there any better way to do it?===<br />
Unfortunately: nope. You might edit the config file but the keymapping format is not human understandable. Sorry!<br />
<br />
===Stella crashed and my phone boots, help!===<br />
From time to time the app crashes and under some rare conditions it takes Luna (webOS GUI Manager) with it. Don't worry, at least it won't destroy anything.<br />
<br />
===Where can I get further help?===<br />
Post a message to the Stella Forum Thread: ''FIXME''<br />
<br />
==Screenshots==<br />
<gallery><br />
Image:Romlauncher.png<br />
Image:Stella_About.png<br />
Image:Stella_Settings.png<br />
Image:Crazy_Climber_(1982)_(Atari).png<br />
Image:Demon_Attack_(1982)_(Imagic).png<br />
Image:Mario_Bros._(1983)_(Atari).png<br />
Image:SwordQuest_-_WaterWorld_(1983)_(Atari).png<br />
Image:Quadrun_(1983)_(Atari)_(Prototype).png<br />
</gallery><br />
<br />
== Feature Requests/TODO ==<br />
<br />
==Known issues==<br />
* Stella crashes if you switch from portrait mode (the default) to landscape mode. Open bug reported to stella maintainer (debilater)<br />
* taking screenshots with the palm (orange+@+p) produces empty images<br />
* if you put stella into the background, the command menu appears<br />
<br />
== Changelog ==<br />
* '''0.0.1'''<br />
** Initial version (stella 3.0 stable)</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=File:Romlauncher.png&diff=9000File:Romlauncher.png2010-02-09T22:33:10Z<p>Debilater: </p>
<hr />
<div></div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Application:Stella&diff=8999Application:Stella2010-02-09T22:31:27Z<p>Debilater: /* Screenshots */</p>
<hr />
<div>=Stella Atari 2600 VCS Emulator 3.0=<br />
[[Image:Stella_icon.png]]Stella is a multi-platform Atari 2600 VCS emulator released under the GNU General Public License (GPL).<br />
<br />
=Credit=<br />
Ported by [http://www.daemon.de/PalmPre Thomas Linden (debilater)] February 2010.<br />
<br />
=Thanks=<br />
First Thanks goes to my beloved wife Leo, without her patience and support I couldn't ever make this happen! Thanks goes to the Stella development team for this awesome emulator! Thanks to the webos-internals team for their hard work on [[WebOS_Internals_PDK|WIDK]]!<br />
<br />
=Donate=<br />
As you might assume, porting software to the palm pre webOS platform is a lot of work, so please consider to [[WebOS_Internals:Site_support|donate]] to the project so that the work can be continued in the future. Thanks!<br />
<br />
=License=<br />
All source is under the GPL license.<br />
The original source code is available [http://stella.sourceforge.net/downloads.php here]<br /><br />
And the latest "Stella Atari 2600 VCS Emulator" for webOS source is available on git [http://git.webos-internals.org/?p=games/stella.git here] <br /><br />
<br />
== Installing VBA ==<br />
Install [[Preware]], and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "stella" (no quotes). Stella should show up. If not, make sure your feeds are up to date. Click on Stella and then click install. You will probably have to install other services as well (it will tell you if you do).<br />
<br/><br />
<br />
Now you are ready to add ROMs(games)!<br />
<br />
==Adding ROMS==<br />
We aren't going to discuss how to get ROMs here but we will tell you how to transfer them to your Pre.<br />
<br />
You may use .a26, .bin, .rom, gz, or .zip Atari 2600 ROM files.<br />
<br />
Connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", "ringtones", and most importantly, a "stella" folder. Click on that and therein the "roms" folder. Copy the ROMs from your computer and move them here. Just put the files there, do not create subdirectories.<br />
<br />
==Controls==<br />
If you have installed some ROM files, start Stella, you will see a list of games available. Select one by tapping on it and tap on the "select" button in the bottom left corner - the game starts. You might also enter some letters, the cursor will then jump to the possition in the list (if there is a match).<br />
<br />
Here is the default Keymapping coming with Stella for webOS:<br />
<br />
* up - w<br />
* down - s<br />
* left - a<br />
* right - d<br />
* jump - space (originally called fire1 too)<br />
* fire2 - f<br />
* fire3 - g<br />
* select - enter<br />
* reset - q<br />
* save - shift<br />
* load - l<br />
* take screenshot - p<br />
* options-menu - delete<br />
* command-menu - c<br />
* close popups - swipe right-to-left (probably ESC)<br />
<br />
==The most important things to know==<br />
<br />
* ''start game'': press space bar<br />
* ''move around'': use w,s,a,d keys (see above)<br />
* ''fire/jump'': press spacebar<br />
* ''switch to landscape mode'': press Delete on keyboard => tap "UI Settings" => tap "Fullscreen" => select "off" => tap button "Ok"<br />
* ''modify keymappings'': press Delete on keyboard => tap "Input Settings" => select a function (current mapping will be displayed below!) => tap "Map" => press the new key => tap "Ok"<br />
* ''take screenshot'': press "p", screenshots will be saved to "/media/internals/stella/screenshots/"<br />
* ''exit current game/return to ROM Launcher'': press "c" key => tap "Exit Game"<br />
* ''exit Stella'': throw it away OR tap "Quit" in ROM Launcher<br />
<br />
==User Guide==<br />
Please don't miss the complete [http://stella.sourceforge.net/docs/index.html Original Stella Userguide]. It will answer all the questions.<br />
<br />
==F.A.Q.==<br />
<br />
===I've bricked my config - stella doesn't start anymore or is unusable!===<br />
Delete the file /media/internals/stella/config/stellarc and start Stella again, it will create a new config with the builtin default parameters<br />
<br />
===Re-Mapping Keys in the Input Preferences Dialog is a nightmare, is there any better way to do it?===<br />
Unfortunately: nope. You might edit the config file but the keymapping format is not human understandable. Sorry!<br />
<br />
===Stella crashed and my phone boots, help!===<br />
From time to time the app crashes and under some rare conditions it takes Luna (webOS GUI Manager) with it. Don't worry, at least it won't destroy anything.<br />
<br />
===Where can I get further help?===<br />
Post a message to the Stella Forum Thread: ''FIXME''<br />
<br />
==Screenshots==<br />
<gallery><br />
Image:Stella_About.png<br />
Image:Stella_Settings.png<br />
Image:Crazy_Climber_(1982)_(Atari).png<br />
Image:Demon_Attack_(1982)_(Imagic).png<br />
Image:Mario_Bros._(1983)_(Atari).png<br />
Image:SwordQuest_-_WaterWorld_(1983)_(Atari).png<br />
Image:Quadrun_(1983)_(Atari)_(Prototype).png<br />
</gallery><br />
<br />
== Feature Requests/TODO ==<br />
<br />
==Known issues==<br />
* Stella crashes if you switch from portrait mode (the default) to landscape mode. Open bug reported to stella maintainer (debilater)<br />
* taking screenshots with the palm (orange+@+p) produces empty images<br />
* if you put stella into the background, the command menu appears<br />
<br />
== Changelog ==<br />
* '''0.0.1'''<br />
** Initial version (stella 3.0 stable)</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=File:Quadrun_(1983)_(Atari)_(Prototype).png&diff=8998File:Quadrun (1983) (Atari) (Prototype).png2010-02-09T22:31:22Z<p>Debilater: </p>
<hr />
<div></div>Debilaterhttp://wiki.webos-internals.org/index.php?title=File:SwordQuest_-_WaterWorld_(1983)_(Atari).png&diff=8997File:SwordQuest - WaterWorld (1983) (Atari).png2010-02-09T22:30:54Z<p>Debilater: </p>
<hr />
<div></div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Application:Stella&diff=8996Application:Stella2010-02-09T22:27:52Z<p>Debilater: /* Controls */</p>
<hr />
<div>=Stella Atari 2600 VCS Emulator 3.0=<br />
[[Image:Stella_icon.png]]Stella is a multi-platform Atari 2600 VCS emulator released under the GNU General Public License (GPL).<br />
<br />
=Credit=<br />
Ported by [http://www.daemon.de/PalmPre Thomas Linden (debilater)] February 2010.<br />
<br />
=Thanks=<br />
First Thanks goes to my beloved wife Leo, without her patience and support I couldn't ever make this happen! Thanks goes to the Stella development team for this awesome emulator! Thanks to the webos-internals team for their hard work on [[WebOS_Internals_PDK|WIDK]]!<br />
<br />
=Donate=<br />
As you might assume, porting software to the palm pre webOS platform is a lot of work, so please consider to [[WebOS_Internals:Site_support|donate]] to the project so that the work can be continued in the future. Thanks!<br />
<br />
=License=<br />
All source is under the GPL license.<br />
The original source code is available [http://stella.sourceforge.net/downloads.php here]<br /><br />
And the latest "Stella Atari 2600 VCS Emulator" for webOS source is available on git [http://git.webos-internals.org/?p=games/stella.git here] <br /><br />
<br />
== Installing VBA ==<br />
Install [[Preware]], and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "stella" (no quotes). Stella should show up. If not, make sure your feeds are up to date. Click on Stella and then click install. You will probably have to install other services as well (it will tell you if you do).<br />
<br/><br />
<br />
Now you are ready to add ROMs(games)!<br />
<br />
==Adding ROMS==<br />
We aren't going to discuss how to get ROMs here but we will tell you how to transfer them to your Pre.<br />
<br />
You may use .a26, .bin, .rom, gz, or .zip Atari 2600 ROM files.<br />
<br />
Connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", "ringtones", and most importantly, a "stella" folder. Click on that and therein the "roms" folder. Copy the ROMs from your computer and move them here. Just put the files there, do not create subdirectories.<br />
<br />
==Controls==<br />
If you have installed some ROM files, start Stella, you will see a list of games available. Select one by tapping on it and tap on the "select" button in the bottom left corner - the game starts. You might also enter some letters, the cursor will then jump to the possition in the list (if there is a match).<br />
<br />
Here is the default Keymapping coming with Stella for webOS:<br />
<br />
* up - w<br />
* down - s<br />
* left - a<br />
* right - d<br />
* jump - space (originally called fire1 too)<br />
* fire2 - f<br />
* fire3 - g<br />
* select - enter<br />
* reset - q<br />
* save - shift<br />
* load - l<br />
* take screenshot - p<br />
* options-menu - delete<br />
* command-menu - c<br />
* close popups - swipe right-to-left (probably ESC)<br />
<br />
==The most important things to know==<br />
<br />
* ''start game'': press space bar<br />
* ''move around'': use w,s,a,d keys (see above)<br />
* ''fire/jump'': press spacebar<br />
* ''switch to landscape mode'': press Delete on keyboard => tap "UI Settings" => tap "Fullscreen" => select "off" => tap button "Ok"<br />
* ''modify keymappings'': press Delete on keyboard => tap "Input Settings" => select a function (current mapping will be displayed below!) => tap "Map" => press the new key => tap "Ok"<br />
* ''take screenshot'': press "p", screenshots will be saved to "/media/internals/stella/screenshots/"<br />
* ''exit current game/return to ROM Launcher'': press "c" key => tap "Exit Game"<br />
* ''exit Stella'': throw it away OR tap "Quit" in ROM Launcher<br />
<br />
==User Guide==<br />
Please don't miss the complete [http://stella.sourceforge.net/docs/index.html Original Stella Userguide]. It will answer all the questions.<br />
<br />
==F.A.Q.==<br />
<br />
===I've bricked my config - stella doesn't start anymore or is unusable!===<br />
Delete the file /media/internals/stella/config/stellarc and start Stella again, it will create a new config with the builtin default parameters<br />
<br />
===Re-Mapping Keys in the Input Preferences Dialog is a nightmare, is there any better way to do it?===<br />
Unfortunately: nope. You might edit the config file but the keymapping format is not human understandable. Sorry!<br />
<br />
===Stella crashed and my phone boots, help!===<br />
From time to time the app crashes and under some rare conditions it takes Luna (webOS GUI Manager) with it. Don't worry, at least it won't destroy anything.<br />
<br />
===Where can I get further help?===<br />
Post a message to the Stella Forum Thread: ''FIXME''<br />
<br />
==Screenshots==<br />
<gallery><br />
Image:Stella_About.png<br />
Image:Stella_Settings.png<br />
Image:Crazy_Climber_(1982)_(Atari).png<br />
Image:Demon_Attack_(1982)_(Imagic).png<br />
Image:Mario_Bros._(1983)_(Atari).png<br />
</gallery><br />
<br />
== Feature Requests/TODO ==<br />
<br />
==Known issues==<br />
* Stella crashes if you switch from portrait mode (the default) to landscape mode. Open bug reported to stella maintainer (debilater)<br />
* taking screenshots with the palm (orange+@+p) produces empty images<br />
* if you put stella into the background, the command menu appears<br />
<br />
== Changelog ==<br />
* '''0.0.1'''<br />
** Initial version (stella 3.0 stable)</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Application:Stella&diff=8995Application:Stella2010-02-09T22:27:12Z<p>Debilater: </p>
<hr />
<div>=Stella Atari 2600 VCS Emulator 3.0=<br />
[[Image:Stella_icon.png]]Stella is a multi-platform Atari 2600 VCS emulator released under the GNU General Public License (GPL).<br />
<br />
=Credit=<br />
Ported by [http://www.daemon.de/PalmPre Thomas Linden (debilater)] February 2010.<br />
<br />
=Thanks=<br />
First Thanks goes to my beloved wife Leo, without her patience and support I couldn't ever make this happen! Thanks goes to the Stella development team for this awesome emulator! Thanks to the webos-internals team for their hard work on [[WebOS_Internals_PDK|WIDK]]!<br />
<br />
=Donate=<br />
As you might assume, porting software to the palm pre webOS platform is a lot of work, so please consider to [[WebOS_Internals:Site_support|donate]] to the project so that the work can be continued in the future. Thanks!<br />
<br />
=License=<br />
All source is under the GPL license.<br />
The original source code is available [http://stella.sourceforge.net/downloads.php here]<br /><br />
And the latest "Stella Atari 2600 VCS Emulator" for webOS source is available on git [http://git.webos-internals.org/?p=games/stella.git here] <br /><br />
<br />
== Installing VBA ==<br />
Install [[Preware]], and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "stella" (no quotes). Stella should show up. If not, make sure your feeds are up to date. Click on Stella and then click install. You will probably have to install other services as well (it will tell you if you do).<br />
<br/><br />
<br />
Now you are ready to add ROMs(games)!<br />
<br />
==Adding ROMS==<br />
We aren't going to discuss how to get ROMs here but we will tell you how to transfer them to your Pre.<br />
<br />
You may use .a26, .bin, .rom, gz, or .zip Atari 2600 ROM files.<br />
<br />
Connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", "ringtones", and most importantly, a "stella" folder. Click on that and therein the "roms" folder. Copy the ROMs from your computer and move them here. Just put the files there, do not create subdirectories.<br />
<br />
==Controls==<br />
If you have installed some ROM files, start Stella, you will see a list of games available. Select one by tapping on it and tap on the "select" button in the bottom left corner - the game starts. You might also enter some letters, the cursor will then jump to the possition in the list (if there is a match).<br />
<br />
Here is the default Keymapping coming with Stella for webOS:<br />
<br />
* up w<br />
* down s<br />
* left a<br />
* right d<br />
* jump space (originally called fire1 too)<br />
* fire2 f<br />
* fire3 g<br />
* select enter<br />
* reset q<br />
* save shift<br />
* load l<br />
* take screenshot p<br />
* options-menu delete<br />
* command-menu c<br />
* close popups swipe right-to-left (probably ESC)<br />
<br />
==The most important things to know==<br />
<br />
* ''start game'': press space bar<br />
* ''move around'': use w,s,a,d keys (see above)<br />
* ''fire/jump'': press spacebar<br />
* ''switch to landscape mode'': press Delete on keyboard => tap "UI Settings" => tap "Fullscreen" => select "off" => tap button "Ok"<br />
* ''modify keymappings'': press Delete on keyboard => tap "Input Settings" => select a function (current mapping will be displayed below!) => tap "Map" => press the new key => tap "Ok"<br />
* ''take screenshot'': press "p", screenshots will be saved to "/media/internals/stella/screenshots/"<br />
* ''exit current game/return to ROM Launcher'': press "c" key => tap "Exit Game"<br />
* ''exit Stella'': throw it away OR tap "Quit" in ROM Launcher<br />
<br />
==User Guide==<br />
Please don't miss the complete [http://stella.sourceforge.net/docs/index.html Original Stella Userguide]. It will answer all the questions.<br />
<br />
==F.A.Q.==<br />
<br />
===I've bricked my config - stella doesn't start anymore or is unusable!===<br />
Delete the file /media/internals/stella/config/stellarc and start Stella again, it will create a new config with the builtin default parameters<br />
<br />
===Re-Mapping Keys in the Input Preferences Dialog is a nightmare, is there any better way to do it?===<br />
Unfortunately: nope. You might edit the config file but the keymapping format is not human understandable. Sorry!<br />
<br />
===Stella crashed and my phone boots, help!===<br />
From time to time the app crashes and under some rare conditions it takes Luna (webOS GUI Manager) with it. Don't worry, at least it won't destroy anything.<br />
<br />
===Where can I get further help?===<br />
Post a message to the Stella Forum Thread: ''FIXME''<br />
<br />
==Screenshots==<br />
<gallery><br />
Image:Stella_About.png<br />
Image:Stella_Settings.png<br />
Image:Crazy_Climber_(1982)_(Atari).png<br />
Image:Demon_Attack_(1982)_(Imagic).png<br />
Image:Mario_Bros._(1983)_(Atari).png<br />
</gallery><br />
<br />
== Feature Requests/TODO ==<br />
<br />
==Known issues==<br />
* Stella crashes if you switch from portrait mode (the default) to landscape mode. Open bug reported to stella maintainer (debilater)<br />
* taking screenshots with the palm (orange+@+p) produces empty images<br />
* if you put stella into the background, the command menu appears<br />
<br />
== Changelog ==<br />
* '''0.0.1'''<br />
** Initial version (stella 3.0 stable)</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Application:Stella&diff=8994Application:Stella2010-02-09T22:19:21Z<p>Debilater: /* Controls */</p>
<hr />
<div>=Stella Atari 2600 VCS Emulator 3.0=<br />
[[Image:Stella_icon.png]]Stella is a multi-platform Atari 2600 VCS emulator released under the GNU General Public License (GPL).<br />
<br />
=Credit=<br />
Ported by [http://www.daemon.de/PalmPre Thomas Linden (debilater)] February 2010.<br />
<br />
=Thanks=<br />
First Thanks goes to my beloved wife Leo, without her patience and support I couldn't ever make this happen! Thanks goes to the Stella development team for this awesome emulator! Thanks to the webos-internals team for their hard work on [[WebOS_Internals_PDK|WIDK]]!<br />
<br />
=Donate=<br />
As you might assume, porting software to the palm pre webOS platform is a lot of work, so please consider to [[WebOS_Internals:Site_support|donate]] to the project so that the work can be continued in the future. Thanks!<br />
<br />
=License=<br />
All source is under the GPL license.<br />
The original source code is available [http://stella.sourceforge.net/downloads.php here]<br /><br />
And the latest "Stella Atari 2600 VCS Emulator" for webOS source is available on git [http://git.webos-internals.org/?p=games/stella.git here] <br /><br />
<br />
== Installing VBA ==<br />
Install [[Preware]], and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "stella" (no quotes). Stella should show up. If not, make sure your feeds are up to date. Click on Stella and then click install. You will probably have to install other services as well (it will tell you if you do).<br />
<br/><br />
<br />
Now you are ready to add ROMs(games)!<br />
<br />
==Adding ROMS==<br />
We aren't going to discuss how to get ROMs here but we will tell you how to transfer them to your Pre.<br />
<br />
You may use .a26, .bin, .rom, gz, or .zip Atari 2600 ROM files.<br />
<br />
Connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", "ringtones", and most importantly, a "stella" folder. Click on that and therein the "roms" folder. Copy the ROMs from your computer and move them here. Just put the files there, do not create subdirectories.<br />
<br />
==Controls==<br />
If you have installed some ROM files, start Stella, you will see a list of games available. Select one by tapping on it and tap on the "select" button in the bottom left corner - the game starts. You might also enter some letters, the cursor will then jump to the possition in the list (if there is a match).<br />
<br />
Here is the default Keymapping coming with Stella for webOS:<br />
<br />
* up w<br />
* down s<br />
* left a<br />
* right d<br />
* jump space (originally called fire1 too)<br />
* fire2 f<br />
* fire3 g<br />
* select enter<br />
* reset q<br />
* save shift<br />
* load l<br />
* take screenshot p<br />
* options-menu delete<br />
* command-menu c<br />
<br />
==The most important things to know==<br />
<br />
* ''start game'': press space bar<br />
* ''move around'': use w,s,a,d keys (see above)<br />
* ''fire/jump'': press spacebar<br />
* ''switch to landscape mode'': press Delete on keyboard => tap "UI Settings" => tap "Fullscreen" => select "off" => tap button "Ok"<br />
* ''modify keymappings'': press Delete on keyboard => tap "Input Settings" => select a function (current mapping will be displayed below!) => tap "Map" => press the new key => tap "Ok"<br />
* ''take screenshot'': press "p", screenshots will be saved to "/media/internals/stella/screenshots/"<br />
* ''exit current game/return to ROM Launcher'': press "c" key => tap "Exit Game"<br />
* ''exit Stella'': throw it away OR tap "Quit" in ROM Launcher<br />
<br />
==User Guide==<br />
Please don't miss the complete [http://stella.sourceforge.net/docs/index.html Original Stella Userguide]. It will answer all the questions.<br />
<br />
==F.A.Q.==<br />
<br />
===I've bricked my config - stella doesn't start anymore or is unusable!===<br />
Delete the file /media/internals/stella/config/stellarc and start Stella again, it will create a new config with the builtin default parameters<br />
<br />
===Re-Mapping Keys in the Input Preferences Dialog is a nightmare, is there any better way to do it?===<br />
Unfortunately: nope. You might edit the config file but the keymapping format is not human understandable. Sorry!<br />
<br />
===Stella crashed and my phone boots, help!===<br />
From time to time the app crashes and under some rare conditions it takes Luna (webOS GUI Manager) with it. Don't worry, at least it won't destroy anything.<br />
<br />
===Where can I get further help?===<br />
Post a message to the Stella Forum Thread: ''FIXME''<br />
<br />
==Screenshots==<br />
<gallery><br />
Image:Stella_About.png<br />
Image:Stella_Settings.png<br />
Image:Crazy_Climber_(1982)_(Atari).png<br />
Image:Demon_Attack_(1982)_(Imagic).png<br />
Image:Mario_Bros._(1983)_(Atari).png<br />
</gallery><br />
<br />
== Feature Requests/TODO ==<br />
<br />
==Known issues==<br />
* Stella crashes if you switch from portrait mode (the default) to landscape mode. Open bug reported to stella maintainer (debilater)<br />
* taking screenshots with the palm (orange+@+p) produces empty images<br />
* if you put stella into the background, the command menu appears<br />
<br />
== Changelog ==<br />
* '''0.0.1'''<br />
** Initial version (stella 3.0 stable)</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Application:Stella&diff=8993Application:Stella2010-02-09T22:17:24Z<p>Debilater: /* Stella crashed and my phone boots, help! */</p>
<hr />
<div>=Stella Atari 2600 VCS Emulator 3.0=<br />
[[Image:Stella_icon.png]]Stella is a multi-platform Atari 2600 VCS emulator released under the GNU General Public License (GPL).<br />
<br />
=Credit=<br />
Ported by [http://www.daemon.de/PalmPre Thomas Linden (debilater)] February 2010.<br />
<br />
=Thanks=<br />
First Thanks goes to my beloved wife Leo, without her patience and support I couldn't ever make this happen! Thanks goes to the Stella development team for this awesome emulator! Thanks to the webos-internals team for their hard work on [[WebOS_Internals_PDK|WIDK]]!<br />
<br />
=Donate=<br />
As you might assume, porting software to the palm pre webOS platform is a lot of work, so please consider to [[WebOS_Internals:Site_support|donate]] to the project so that the work can be continued in the future. Thanks!<br />
<br />
=License=<br />
All source is under the GPL license.<br />
The original source code is available [http://stella.sourceforge.net/downloads.php here]<br /><br />
And the latest "Stella Atari 2600 VCS Emulator" for webOS source is available on git [http://git.webos-internals.org/?p=games/stella.git here] <br /><br />
<br />
== Installing VBA ==<br />
Install [[Preware]], and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "stella" (no quotes). Stella should show up. If not, make sure your feeds are up to date. Click on Stella and then click install. You will probably have to install other services as well (it will tell you if you do).<br />
<br/><br />
<br />
Now you are ready to add ROMs(games)!<br />
<br />
==Adding ROMS==<br />
We aren't going to discuss how to get ROMs here but we will tell you how to transfer them to your Pre.<br />
<br />
You may use .a26, .bin, .rom, gz, or .zip Atari 2600 ROM files.<br />
<br />
Connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", "ringtones", and most importantly, a "stella" folder. Click on that and therein the "roms" folder. Copy the ROMs from your computer and move them here. Just put the files there, do not create subdirectories.<br />
<br />
==Controls==<br />
If you have installed some ROM files, start Stella, you will see a list of games available. Select one by tapping on it and tap on the "select" button in the bottom left corner - the game starts.<br />
<br />
Here is the default Keymapping coming with Stella:<br />
<br />
* up w<br />
* down s<br />
* left a<br />
* right d<br />
* jump space (originally called fire1 too)<br />
* fire2 f<br />
* fire3 g<br />
* select enter<br />
* reset q<br />
* save shift<br />
* load l<br />
* take screenshot p<br />
* options-menu delete<br />
* command-menu c<br />
<br />
==The most important things to know==<br />
<br />
* ''start game'': press space bar<br />
* ''move around'': use w,s,a,d keys (see above)<br />
* ''fire/jump'': press spacebar<br />
* ''switch to landscape mode'': press Delete on keyboard => tap "UI Settings" => tap "Fullscreen" => select "off" => tap button "Ok"<br />
* ''modify keymappings'': press Delete on keyboard => tap "Input Settings" => select a function (current mapping will be displayed below!) => tap "Map" => press the new key => tap "Ok"<br />
* ''take screenshot'': press "p", screenshots will be saved to "/media/internals/stella/screenshots/"<br />
* ''exit current game/return to ROM Launcher'': press "c" key => tap "Exit Game"<br />
* ''exit Stella'': throw it away OR tap "Quit" in ROM Launcher<br />
<br />
==User Guide==<br />
Please don't miss the complete [http://stella.sourceforge.net/docs/index.html Original Stella Userguide]. It will answer all the questions.<br />
<br />
==F.A.Q.==<br />
<br />
===I've bricked my config - stella doesn't start anymore or is unusable!===<br />
Delete the file /media/internals/stella/config/stellarc and start Stella again, it will create a new config with the builtin default parameters<br />
<br />
===Re-Mapping Keys in the Input Preferences Dialog is a nightmare, is there any better way to do it?===<br />
Unfortunately: nope. You might edit the config file but the keymapping format is not human understandable. Sorry!<br />
<br />
===Stella crashed and my phone boots, help!===<br />
From time to time the app crashes and under some rare conditions it takes Luna (webOS GUI Manager) with it. Don't worry, at least it won't destroy anything.<br />
<br />
===Where can I get further help?===<br />
Post a message to the Stella Forum Thread: ''FIXME''<br />
<br />
==Screenshots==<br />
<gallery><br />
Image:Stella_About.png<br />
Image:Stella_Settings.png<br />
Image:Crazy_Climber_(1982)_(Atari).png<br />
Image:Demon_Attack_(1982)_(Imagic).png<br />
Image:Mario_Bros._(1983)_(Atari).png<br />
</gallery><br />
<br />
== Feature Requests/TODO ==<br />
<br />
==Known issues==<br />
* Stella crashes if you switch from portrait mode (the default) to landscape mode. Open bug reported to stella maintainer (debilater)<br />
* taking screenshots with the palm (orange+@+p) produces empty images<br />
* if you put stella into the background, the command menu appears<br />
<br />
== Changelog ==<br />
* '''0.0.1'''<br />
** Initial version (stella 3.0 stable)</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Application:Stella&diff=8992Application:Stella2010-02-09T22:16:01Z<p>Debilater: </p>
<hr />
<div>=Stella Atari 2600 VCS Emulator 3.0=<br />
[[Image:Stella_icon.png]]Stella is a multi-platform Atari 2600 VCS emulator released under the GNU General Public License (GPL).<br />
<br />
=Credit=<br />
Ported by [http://www.daemon.de/PalmPre Thomas Linden (debilater)] February 2010.<br />
<br />
=Thanks=<br />
First Thanks goes to my beloved wife Leo, without her patience and support I couldn't ever make this happen! Thanks goes to the Stella development team for this awesome emulator! Thanks to the webos-internals team for their hard work on [[WebOS_Internals_PDK|WIDK]]!<br />
<br />
=Donate=<br />
As you might assume, porting software to the palm pre webOS platform is a lot of work, so please consider to [[WebOS_Internals:Site_support|donate]] to the project so that the work can be continued in the future. Thanks!<br />
<br />
=License=<br />
All source is under the GPL license.<br />
The original source code is available [http://stella.sourceforge.net/downloads.php here]<br /><br />
And the latest "Stella Atari 2600 VCS Emulator" for webOS source is available on git [http://git.webos-internals.org/?p=games/stella.git here] <br /><br />
<br />
== Installing VBA ==<br />
Install [[Preware]], and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "stella" (no quotes). Stella should show up. If not, make sure your feeds are up to date. Click on Stella and then click install. You will probably have to install other services as well (it will tell you if you do).<br />
<br/><br />
<br />
Now you are ready to add ROMs(games)!<br />
<br />
==Adding ROMS==<br />
We aren't going to discuss how to get ROMs here but we will tell you how to transfer them to your Pre.<br />
<br />
You may use .a26, .bin, .rom, gz, or .zip Atari 2600 ROM files.<br />
<br />
Connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", "ringtones", and most importantly, a "stella" folder. Click on that and therein the "roms" folder. Copy the ROMs from your computer and move them here. Just put the files there, do not create subdirectories.<br />
<br />
==Controls==<br />
If you have installed some ROM files, start Stella, you will see a list of games available. Select one by tapping on it and tap on the "select" button in the bottom left corner - the game starts.<br />
<br />
Here is the default Keymapping coming with Stella:<br />
<br />
* up w<br />
* down s<br />
* left a<br />
* right d<br />
* jump space (originally called fire1 too)<br />
* fire2 f<br />
* fire3 g<br />
* select enter<br />
* reset q<br />
* save shift<br />
* load l<br />
* take screenshot p<br />
* options-menu delete<br />
* command-menu c<br />
<br />
==The most important things to know==<br />
<br />
* ''start game'': press space bar<br />
* ''move around'': use w,s,a,d keys (see above)<br />
* ''fire/jump'': press spacebar<br />
* ''switch to landscape mode'': press Delete on keyboard => tap "UI Settings" => tap "Fullscreen" => select "off" => tap button "Ok"<br />
* ''modify keymappings'': press Delete on keyboard => tap "Input Settings" => select a function (current mapping will be displayed below!) => tap "Map" => press the new key => tap "Ok"<br />
* ''take screenshot'': press "p", screenshots will be saved to "/media/internals/stella/screenshots/"<br />
* ''exit current game/return to ROM Launcher'': press "c" key => tap "Exit Game"<br />
* ''exit Stella'': throw it away OR tap "Quit" in ROM Launcher<br />
<br />
==User Guide==<br />
Please don't miss the complete [http://stella.sourceforge.net/docs/index.html Original Stella Userguide]. It will answer all the questions.<br />
<br />
==F.A.Q.==<br />
<br />
===I've bricked my config - stella doesn't start anymore or is unusable!===<br />
Delete the file /media/internals/stella/config/stellarc and start Stella again, it will create a new config with the builtin default parameters<br />
<br />
===Re-Mapping Keys in the Input Preferences Dialog is a nightmare, is there any better way to do it?===<br />
Unfortunately: nope. You might edit the config file but the keymapping format is not human understandable. Sorry!<br />
<br />
===Stella crashed and my phone boots, help!===<br />
From time to time the app crashes and takes in some rare cases Luna with it. Don't worry, at least it won't destroy anything.<br />
<br />
===Where can I get further help?===<br />
Post a message to the Stella Forum Thread: ''FIXME''<br />
<br />
==Screenshots==<br />
<gallery><br />
Image:Stella_About.png<br />
Image:Stella_Settings.png<br />
Image:Crazy_Climber_(1982)_(Atari).png<br />
Image:Demon_Attack_(1982)_(Imagic).png<br />
Image:Mario_Bros._(1983)_(Atari).png<br />
</gallery><br />
<br />
== Feature Requests/TODO ==<br />
<br />
==Known issues==<br />
* Stella crashes if you switch from portrait mode (the default) to landscape mode. Open bug reported to stella maintainer (debilater)<br />
* taking screenshots with the palm (orange+@+p) produces empty images<br />
* if you put stella into the background, the command menu appears<br />
<br />
== Changelog ==<br />
* '''0.0.1'''<br />
** Initial version (stella 3.0 stable)</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Application:Stella&diff=8991Application:Stella2010-02-09T22:07:50Z<p>Debilater: /* The most important things to know */</p>
<hr />
<div>=Stella Atari 2600 VCS Emulator 3.0=<br />
[[Image:Stella_icon.png]]Stella is a multi-platform Atari 2600 VCS emulator released under the GNU General Public License (GPL).<br />
<br />
=Credit=<br />
Ported by [http://www.daemon.de/PalmPre Thomas Linden (debilater)] February 2010.<br />
<br />
=Thanks=<br />
First Thanks goes to my beloved wife Leo, without her patience and support I couldn't ever make this happen! Thanks goes to the Stella development team for this awesome emulator! Thanks to the webos-internals team for their hard work on [[WebOS_Internals_PDK|WIDK]]!<br />
<br />
=Donate=<br />
As you might assume, porting software to the palm pre webOS platform is a lot of work, so please consider to [[WebOS_Internals:Site_support|donate]] to the project so that the work can be continued in the future. Thanks!<br />
<br />
=License=<br />
All source is under the GPL license.<br />
The original source code is available [http://stella.sourceforge.net/downloads.php here]<br /><br />
And the latest "Stella Atari 2600 VCS Emulator" for webOS source is available on git [http://git.webos-internals.org/?p=games/stella.git here] <br /><br />
<br />
== Installing VBA ==<br />
Install [[Preware]], and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "stella" (no quotes). Stella should show up. If not, make sure your feeds are up to date. Click on Stella and then click install. You will probably have to install other services as well (it will tell you if you do).<br />
<br/><br />
<br />
Now you are ready to add ROMs(games)!<br />
<br />
==Adding ROMS==<br />
We aren't going to discuss how to get ROMs here but we will tell you how to transfer them to your Pre.<br />
<br />
You may use .a26, .bin, .rom, gz, or .zip Atari 2600 ROM files.<br />
<br />
Connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", "ringtones", and most importantly, a "stella" folder. Click on that and therein the "roms" folder. Copy the ROMs from your computer and move them here. Just put the files there, do not create subdirectories.<br />
<br />
==Controls==<br />
If you have installed some ROM files, start Stella, you will see a list of games available. Select one by tapping on it and tap on the "select" button in the bottom left corner - the game starts.<br />
<br />
Here is the default Keymapping coming with Stella:<br />
<br />
* up w<br />
* down s<br />
* left a<br />
* right d<br />
* jump space (originally called fire1 too)<br />
* fire2 f<br />
* fire3 g<br />
* select enter<br />
* reset q<br />
* save shift<br />
* load l<br />
* take screenshot p<br />
* options-menu delete<br />
* command-menu c<br />
<br />
==The most important things to know==<br />
<br />
* ''start game'': press space bar<br />
* ''move around'': use w,s,a,d keys (see above)<br />
* ''fire/jump'': press spacebar<br />
* ''switch to landscape mode'': press Delete on keyboard => tap "UI Settings" => tap "Fullscreen" => select "off" => tap button "Ok"<br />
* ''modify keymappings'': press Delete on keyboard => tap "Input Settings" => select a function (current mapping will be displayed below!) => tap "Map" => press the new key => tap "Ok"<br />
* ''take screenshot'': press "p", screenshots will be saved to "/media/internals/stella/screenshots/"<br />
* ''exit current game/return to ROM Launcher'': press "c" key => tap "Exit Game"<br />
* ''exit Stella'': throw it away OR tap "Quit" in ROM Launcher<br />
<br />
==User Guide==<br />
Please don't miss the complete [http://stella.sourceforge.net/docs/index.html Original Stella Userguide]. It will answer all the questions.<br />
<br />
==Screenshots==<br />
<gallery><br />
Image:Stella_About.png<br />
Image:Stella_Settings.png<br />
Image:Crazy_Climber_(1982)_(Atari).png<br />
Image:Demon_Attack_(1982)_(Imagic).png<br />
Image:Mario_Bros._(1983)_(Atari).png<br />
</gallery><br />
<br />
== Feature Requests/TODO ==<br />
<br />
==Known issues==<br />
* Stella crashes if you switch from portrait mode (the default) to landscape mode. Open bug reported to stella maintainer (debilater)<br />
* taking screenshots with the palm (orange+@+p) produces empty images<br />
* if you put stella into the background, the command menu appears<br />
<br />
== Changelog ==<br />
* '''0.0.1'''<br />
** Initial version (stella 3.0 stable)</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Application:Stella&diff=8990Application:Stella2010-02-09T21:29:43Z<p>Debilater: /* Thanks */</p>
<hr />
<div>=Stella Atari 2600 VCS Emulator 3.0=<br />
[[Image:Stella_icon.png]]Stella is a multi-platform Atari 2600 VCS emulator released under the GNU General Public License (GPL).<br />
<br />
=Credit=<br />
Ported by [http://www.daemon.de/PalmPre Thomas Linden (debilater)] February 2010.<br />
<br />
=Thanks=<br />
First Thanks goes to my beloved wife Leo, without her patience and support I couldn't ever make this happen! Thanks goes to the Stella development team for this awesome emulator! Thanks to the webos-internals team for their hard work on [[WebOS_Internals_PDK|WIDK]]!<br />
<br />
=Donate=<br />
As you might assume, porting software to the palm pre webOS platform is a lot of work, so please consider to [[WebOS_Internals:Site_support|donate]] to the project so that the work can be continued in the future. Thanks!<br />
<br />
=License=<br />
All source is under the GPL license.<br />
The original source code is available [http://stella.sourceforge.net/downloads.php here]<br /><br />
And the latest "Stella Atari 2600 VCS Emulator" for webOS source is available on git [http://git.webos-internals.org/?p=games/stella.git here] <br /><br />
<br />
== Installing VBA ==<br />
Install [[Preware]], and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "stella" (no quotes). Stella should show up. If not, make sure your feeds are up to date. Click on Stella and then click install. You will probably have to install other services as well (it will tell you if you do).<br />
<br/><br />
<br />
Now you are ready to add ROMs(games)!<br />
<br />
==Adding ROMS==<br />
We aren't going to discuss how to get ROMs here but we will tell you how to transfer them to your Pre.<br />
<br />
You may use .a26, .bin, .rom, gz, or .zip Atari 2600 ROM files.<br />
<br />
Connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", "ringtones", and most importantly, a "stella" folder. Click on that and therein the "roms" folder. Copy the ROMs from your computer and move them here. Just put the files there, do not create subdirectories.<br />
<br />
==Controls==<br />
If you have installed some ROM files, start Stella, you will see a list of games available. Select one by tapping on it and tap on the "select" button in the bottom left corner - the game starts.<br />
<br />
Here is the default Keymapping coming with Stella:<br />
<br />
* up w<br />
* down s<br />
* left a<br />
* right d<br />
* jump space (originally called fire1 too)<br />
* fire2 f<br />
* fire3 g<br />
* select enter<br />
* reset q<br />
* save shift<br />
* load l<br />
* take screenshot p<br />
* options-menu delete<br />
* command-menu c<br />
<br />
==The most important things to know==<br />
<br />
* ''start game'': pres space bar<br />
* ''move around'': use w,s,a,d keys (see above)<br />
* ''fire/jump'': pres spacebar<br />
* ''switch to landscape mode'': press Delete on keyboard => tap "UI Settings" => tap "Fullscreen" => select "off" => tap button "Ok"<br />
* ''modify keymappings'': press Delete on keyboard => tap "Input Settings" => select a function (current mapping will be displayed below!) => tap "Map" => press the new key => tap "Ok"<br />
* ''take screenshot'': press "p", screenshots will be saved to "/media/internals/stella/screenshots/"<br />
* ''exit current game/return to ROM Launcher'': press "c" key => tap "Exit Game"<br />
* ''exit Stella'': throw it away OR tap "Quit" in ROM Launcher<br />
<br />
==User Guide==<br />
Please don't miss the complete [http://stella.sourceforge.net/docs/index.html Original Stella Userguide]. It will answer all the questions.<br />
<br />
==Screenshots==<br />
<gallery><br />
Image:Stella_About.png<br />
Image:Stella_Settings.png<br />
Image:Crazy_Climber_(1982)_(Atari).png<br />
Image:Demon_Attack_(1982)_(Imagic).png<br />
Image:Mario_Bros._(1983)_(Atari).png<br />
</gallery><br />
<br />
== Feature Requests/TODO ==<br />
<br />
==Known issues==<br />
* Stella crashes if you switch from portrait mode (the default) to landscape mode. Open bug reported to stella maintainer (debilater)<br />
* taking screenshots with the palm (orange+@+p) produces empty images<br />
* if you put stella into the background, the command menu appears<br />
<br />
== Changelog ==<br />
* '''0.0.1'''<br />
** Initial version (stella 3.0 stable)</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Application:Stella&diff=8989Application:Stella2010-02-09T21:28:51Z<p>Debilater: /* Thanks */</p>
<hr />
<div>=Stella Atari 2600 VCS Emulator 3.0=<br />
[[Image:Stella_icon.png]]Stella is a multi-platform Atari 2600 VCS emulator released under the GNU General Public License (GPL).<br />
<br />
=Credit=<br />
Ported by [http://www.daemon.de/PalmPre Thomas Linden (debilater)] February 2010.<br />
<br />
=Thanks=<br />
First Thanks goes to my beloved wife Leo, without her patience and support Stella I couldn't ever make this happen! Thanks goes to the Stella development team for this awesome emulator! Thanks to the webos-internals team for their hard work on [[WebOS_Internals_PDK|WIDK]]!<br />
<br />
=Donate=<br />
As you might assume, porting software to the palm pre webOS platform is a lot of work, so please consider to [[WebOS_Internals:Site_support|donate]] to the project so that the work can be continued in the future. Thanks!<br />
<br />
=License=<br />
All source is under the GPL license.<br />
The original source code is available [http://stella.sourceforge.net/downloads.php here]<br /><br />
And the latest "Stella Atari 2600 VCS Emulator" for webOS source is available on git [http://git.webos-internals.org/?p=games/stella.git here] <br /><br />
<br />
== Installing VBA ==<br />
Install [[Preware]], and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "stella" (no quotes). Stella should show up. If not, make sure your feeds are up to date. Click on Stella and then click install. You will probably have to install other services as well (it will tell you if you do).<br />
<br/><br />
<br />
Now you are ready to add ROMs(games)!<br />
<br />
==Adding ROMS==<br />
We aren't going to discuss how to get ROMs here but we will tell you how to transfer them to your Pre.<br />
<br />
You may use .a26, .bin, .rom, gz, or .zip Atari 2600 ROM files.<br />
<br />
Connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", "ringtones", and most importantly, a "stella" folder. Click on that and therein the "roms" folder. Copy the ROMs from your computer and move them here. Just put the files there, do not create subdirectories.<br />
<br />
==Controls==<br />
If you have installed some ROM files, start Stella, you will see a list of games available. Select one by tapping on it and tap on the "select" button in the bottom left corner - the game starts.<br />
<br />
Here is the default Keymapping coming with Stella:<br />
<br />
* up w<br />
* down s<br />
* left a<br />
* right d<br />
* jump space (originally called fire1 too)<br />
* fire2 f<br />
* fire3 g<br />
* select enter<br />
* reset q<br />
* save shift<br />
* load l<br />
* take screenshot p<br />
* options-menu delete<br />
* command-menu c<br />
<br />
==The most important things to know==<br />
<br />
* ''start game'': pres space bar<br />
* ''move around'': use w,s,a,d keys (see above)<br />
* ''fire/jump'': pres spacebar<br />
* ''switch to landscape mode'': press Delete on keyboard => tap "UI Settings" => tap "Fullscreen" => select "off" => tap button "Ok"<br />
* ''modify keymappings'': press Delete on keyboard => tap "Input Settings" => select a function (current mapping will be displayed below!) => tap "Map" => press the new key => tap "Ok"<br />
* ''take screenshot'': press "p", screenshots will be saved to "/media/internals/stella/screenshots/"<br />
* ''exit current game/return to ROM Launcher'': press "c" key => tap "Exit Game"<br />
* ''exit Stella'': throw it away OR tap "Quit" in ROM Launcher<br />
<br />
==User Guide==<br />
Please don't miss the complete [http://stella.sourceforge.net/docs/index.html Original Stella Userguide]. It will answer all the questions.<br />
<br />
==Screenshots==<br />
<gallery><br />
Image:Stella_About.png<br />
Image:Stella_Settings.png<br />
Image:Crazy_Climber_(1982)_(Atari).png<br />
Image:Demon_Attack_(1982)_(Imagic).png<br />
Image:Mario_Bros._(1983)_(Atari).png<br />
</gallery><br />
<br />
== Feature Requests/TODO ==<br />
<br />
==Known issues==<br />
* Stella crashes if you switch from portrait mode (the default) to landscape mode. Open bug reported to stella maintainer (debilater)<br />
* taking screenshots with the palm (orange+@+p) produces empty images<br />
* if you put stella into the background, the command menu appears<br />
<br />
== Changelog ==<br />
* '''0.0.1'''<br />
** Initial version (stella 3.0 stable)</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Application:Stella&diff=8988Application:Stella2010-02-09T21:28:36Z<p>Debilater: </p>
<hr />
<div>=Stella Atari 2600 VCS Emulator 3.0=<br />
[[Image:Stella_icon.png]]Stella is a multi-platform Atari 2600 VCS emulator released under the GNU General Public License (GPL).<br />
<br />
=Credit=<br />
Ported by [http://www.daemon.de/PalmPre Thomas Linden (debilater)] February 2010.<br />
<br />
=Thanks=<br />
First Thanks goes to my beloved wife Leo, without her patience and support Stella I couldn't ever make this happen! Thanks goes to the Stella development team for this awesome emulator! Thanks to the webos-internals team for their hard work on [WebOS_Internals_PDK|WIDK]!<br />
<br />
=Donate=<br />
As you might assume, porting software to the palm pre webOS platform is a lot of work, so please consider to [[WebOS_Internals:Site_support|donate]] to the project so that the work can be continued in the future. Thanks!<br />
<br />
=License=<br />
All source is under the GPL license.<br />
The original source code is available [http://stella.sourceforge.net/downloads.php here]<br /><br />
And the latest "Stella Atari 2600 VCS Emulator" for webOS source is available on git [http://git.webos-internals.org/?p=games/stella.git here] <br /><br />
<br />
== Installing VBA ==<br />
Install [[Preware]], and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "stella" (no quotes). Stella should show up. If not, make sure your feeds are up to date. Click on Stella and then click install. You will probably have to install other services as well (it will tell you if you do).<br />
<br/><br />
<br />
Now you are ready to add ROMs(games)!<br />
<br />
==Adding ROMS==<br />
We aren't going to discuss how to get ROMs here but we will tell you how to transfer them to your Pre.<br />
<br />
You may use .a26, .bin, .rom, gz, or .zip Atari 2600 ROM files.<br />
<br />
Connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", "ringtones", and most importantly, a "stella" folder. Click on that and therein the "roms" folder. Copy the ROMs from your computer and move them here. Just put the files there, do not create subdirectories.<br />
<br />
==Controls==<br />
If you have installed some ROM files, start Stella, you will see a list of games available. Select one by tapping on it and tap on the "select" button in the bottom left corner - the game starts.<br />
<br />
Here is the default Keymapping coming with Stella:<br />
<br />
* up w<br />
* down s<br />
* left a<br />
* right d<br />
* jump space (originally called fire1 too)<br />
* fire2 f<br />
* fire3 g<br />
* select enter<br />
* reset q<br />
* save shift<br />
* load l<br />
* take screenshot p<br />
* options-menu delete<br />
* command-menu c<br />
<br />
==The most important things to know==<br />
<br />
* ''start game'': pres space bar<br />
* ''move around'': use w,s,a,d keys (see above)<br />
* ''fire/jump'': pres spacebar<br />
* ''switch to landscape mode'': press Delete on keyboard => tap "UI Settings" => tap "Fullscreen" => select "off" => tap button "Ok"<br />
* ''modify keymappings'': press Delete on keyboard => tap "Input Settings" => select a function (current mapping will be displayed below!) => tap "Map" => press the new key => tap "Ok"<br />
* ''take screenshot'': press "p", screenshots will be saved to "/media/internals/stella/screenshots/"<br />
* ''exit current game/return to ROM Launcher'': press "c" key => tap "Exit Game"<br />
* ''exit Stella'': throw it away OR tap "Quit" in ROM Launcher<br />
<br />
==User Guide==<br />
Please don't miss the complete [http://stella.sourceforge.net/docs/index.html Original Stella Userguide]. It will answer all the questions.<br />
<br />
==Screenshots==<br />
<gallery><br />
Image:Stella_About.png<br />
Image:Stella_Settings.png<br />
Image:Crazy_Climber_(1982)_(Atari).png<br />
Image:Demon_Attack_(1982)_(Imagic).png<br />
Image:Mario_Bros._(1983)_(Atari).png<br />
</gallery><br />
<br />
== Feature Requests/TODO ==<br />
<br />
==Known issues==<br />
* Stella crashes if you switch from portrait mode (the default) to landscape mode. Open bug reported to stella maintainer (debilater)<br />
* taking screenshots with the palm (orange+@+p) produces empty images<br />
* if you put stella into the background, the command menu appears<br />
<br />
== Changelog ==<br />
* '''0.0.1'''<br />
** Initial version (stella 3.0 stable)</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Application:Stella&diff=8987Application:Stella2010-02-09T21:23:04Z<p>Debilater: </p>
<hr />
<div>=Stella Atari 2600 VCS Emulator 3.0=<br />
[[Image:Stella_icon.png]]Stella is a multi-platform Atari 2600 VCS emulator released under the GNU General Public License (GPL).<br />
<br />
=Credit=<br />
Ported by [http://www.daemon.de/PalmPre Thomas Linden (debilater)] February 2010.<br />
<br />
=Donate=<br />
As you might assume, porting software to the palm pre webOS platform is a lot of work, so please consider to [[WebOS_Internals:Site_support|donate]] to the project so that the work can be continued in the future. Thanks!<br />
<br />
=License=<br />
All source is under the GPL license.<br />
The original source code is available [http://stella.sourceforge.net/downloads.php here]<br /><br />
And the latest "Stella Atari 2600 VCS Emulator" for webOS source is available on git [http://git.webos-internals.org/?p=games/stella.git here] <br /><br />
<br />
== Installing VBA ==<br />
Install [[Preware]], and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "stella" (no quotes). Stella should show up. If not, make sure your feeds are up to date. Click on Stella and then click install. You will probably have to install other services as well (it will tell you if you do).<br />
<br/><br />
<br />
Now you are ready to add ROMs(games)!<br />
<br />
==Adding ROMS==<br />
We aren't going to discuss how to get ROMs here but we will tell you how to transfer them to your Pre.<br />
<br />
You may use .a26, .bin, .rom, gz, or .zip Atari 2600 ROM files.<br />
<br />
Connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", "ringtones", and most importantly, a "stella" folder. Click on that and therein the "roms" folder. Copy the ROMs from your computer and move them here. Just put the files there, do not create subdirectories.<br />
<br />
==Controls==<br />
If you have installed some ROM files, start Stella, you will see a list of games available. Select one by tapping on it and tap on the "select" button in the bottom left corner - the game starts.<br />
<br />
Here is the default Keymapping coming with Stella:<br />
<br />
* up w<br />
* down s<br />
* left a<br />
* right d<br />
* jump space (originally called fire1 too)<br />
* fire2 f<br />
* fire3 g<br />
* select enter<br />
* reset q<br />
* save shift<br />
* load l<br />
* take screenshot p<br />
* options-menu delete<br />
* command-menu c<br />
<br />
==The most important things to know==<br />
<br />
* ''start game'': pres space bar<br />
* ''move around'': use w,s,a,d keys (see above)<br />
* ''fire/jump'': pres spacebar<br />
* ''switch to landscape mode'': press Delete on keyboard => tap "UI Settings" => tap "Fullscreen" => select "off" => tap button "Ok"<br />
* ''modify keymappings'': press Delete on keyboard => tap "Input Settings" => select a function (current mapping will be displayed below!) => tap "Map" => press the new key => tap "Ok"<br />
* ''take screenshot'': press "p", screenshots will be saved to "/media/internals/stella/screenshots/"<br />
* ''exit current game/return to ROM Launcher'': press "c" key => tap "Exit Game"<br />
* ''exit Stella'': throw it away OR tap "Quit" in ROM Launcher<br />
<br />
==User Guide==<br />
Please don't miss the complete [http://stella.sourceforge.net/docs/index.html Original Stella Userguide]. It will answer all the questions.<br />
<br />
==Screenshots==<br />
<gallery><br />
Image:Stella_About.png<br />
Image:Stella_Settings.png<br />
Image:Crazy_Climber_(1982)_(Atari).png<br />
Image:Demon_Attack_(1982)_(Imagic).png<br />
Image:Mario_Bros._(1983)_(Atari).png<br />
</gallery><br />
<br />
== Feature Requests/TODO ==<br />
<br />
==Known issues==<br />
* Stella crashes if you switch from portrait mode (the default) to landscape mode. Open bug reported to stella maintainer (debilater)<br />
* taking screenshots with the palm (orange+@+p) produces empty images<br />
* if you put stella into the background, the command menu appears<br />
<br />
== Changelog ==<br />
* '''0.0.1'''<br />
** Initial version (stella 3.0 stable)</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Application:Stella&diff=8986Application:Stella2010-02-09T21:00:36Z<p>Debilater: /* Donate */</p>
<hr />
<div>=Stella Atari 2600 VCS Emulator 3.0=<br />
[[Image:Stella_icon.png]]Stella is a multi-platform Atari 2600 VCS emulator released under the GNU General Public License (GPL).<br />
<br />
=Credit=<br />
Ported by [http://www.daemon.de/PalmPre Thomas Linden (debilater)] February 2010.<br />
<br />
=Donate=<br />
As you might assume, porting software to the palm pre webOS platform is a lot of work, so please consider to [[WebOS_Internals:Site_support|donate]] to the project so that the work can be continued in the future. Thanks!<br />
<br />
=License=<br />
All source is under the GPL license.<br />
The original source code is available [http://stella.sourceforge.net/downloads.php here]<br /><br />
And the latest "Stella Atari 2600 VCS Emulator" for webOS source is available on git [http://git.webos-internals.org/?p=games/stella.git here] <br /><br />
<br />
== Installing VBA ==<br />
Install [[Preware]], and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "stella" (no quotes). Stella should show up. If not, make sure your feeds are up to date. Click on Stella and then click install. You will probably have to install other services as well (it will tell you if you do).<br />
<br/><br />
<br />
Now you are ready to add ROMs(games)!<br />
<br />
==Adding ROMS==<br />
We aren't going to discuss how to get ROMs here but we will tell you how to transfer them to your Pre.<br />
<br />
You may use .a26, .bin, .rom, gz, or .zip Atari 2600 ROM files.<br />
<br />
Connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", "ringtones", and most importantly, a "stella" folder. Click on that and therein the "roms" folder. Copy the ROMs from your computer and move them here. Just put the files there, do not create subdirectories.<br />
<br />
==Controls==<br />
If you have installed some ROM files, start Stella, you will see a list of games available. Select one by tapping on it and tap on the "select" button in the bottom left corner - the game starts.<br />
<br />
Here is the default Keymapping coming with Stella:<br />
<br />
* up w<br />
* down s<br />
* left a<br />
* right d<br />
* jump space (originally called fire1 too)<br />
* fire2 f<br />
* fire3 g<br />
* select enter<br />
* reset q<br />
* save shift<br />
* load l<br />
* take screenshot p<br />
* options-menu delete<br />
* command-menu c<br />
<br />
==The most important things to know==<br />
<br />
* ''start game'': pres space bar<br />
* ''move around'': use w,s,a,d keys (see above)<br />
* ''fire/jump'': pres spacebar<br />
* ''switch to landscape mode'': press Delete on keyboard => tap "UI Settings" => tap "Fullscreen" => select "off" => tap button "Ok"<br />
* ''modify keymappings'': press Delete on keyboard => tap "Input Settings" => select a function (current mapping will be displayed below!) => tap "Map" => press the new key => tap "Ok"<br />
* ''take screenshot'': press "p", screenshots will be saved to "/media/internals/stella/screenshots/"<br />
* ''exit current game/return to ROM Launcher'': press "c" key => tap "Exit Game"<br />
* ''exit Stella'': throw it away OR tap "Quit" in ROM Launcher<br />
<br />
==Screenshots==<br />
<gallery><br />
Image:Stella_About.png<br />
Image:Stella_Settings.png<br />
Image:Crazy_Climber_(1982)_(Atari).png<br />
Image:Demon_Attack_(1982)_(Imagic).png<br />
Image:Mario_Bros._(1983)_(Atari).png<br />
</gallery><br />
<br />
== Feature Requests/TODO ==<br />
<br />
==Known issues==<br />
* Stella crashes if you switch from portrait mode (the default) to landscape mode. Open bug reported to stella maintainer (debilater)<br />
* taking screenshots with the palm (orange+@+p) produces empty images<br />
* if you put stella into the background, the command menu appears<br />
<br />
== Changelog ==<br />
* '''0.0.1'''<br />
** Initial version (stella 3.0 stable)</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Application:Stella&diff=8985Application:Stella2010-02-09T20:58:56Z<p>Debilater: </p>
<hr />
<div>=Stella Atari 2600 VCS Emulator 3.0=<br />
[[Image:Stella_icon.png]]Stella is a multi-platform Atari 2600 VCS emulator released under the GNU General Public License (GPL).<br />
<br />
=Credit=<br />
Ported by [http://www.daemon.de/PalmPre Thomas Linden (debilater)] February 2010.<br />
<br />
=Donate=<br />
As you might assume, porting software to the palm pre webOS platform is a lot of work, so pleas consider to [WebOS_Internals:Site_support donate] to the project so that the work can be continued in the future. Thanks!<br />
<br />
=License=<br />
All source is under the GPL license.<br />
The original source code is available [http://stella.sourceforge.net/downloads.php here]<br /><br />
And the latest "Stella Atari 2600 VCS Emulator" for webOS source is available on git [http://git.webos-internals.org/?p=games/stella.git here] <br /><br />
<br />
== Installing VBA ==<br />
Install [[Preware]], and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "stella" (no quotes). Stella should show up. If not, make sure your feeds are up to date. Click on Stella and then click install. You will probably have to install other services as well (it will tell you if you do).<br />
<br/><br />
<br />
Now you are ready to add ROMs(games)!<br />
<br />
==Adding ROMS==<br />
We aren't going to discuss how to get ROMs here but we will tell you how to transfer them to your Pre.<br />
<br />
You may use .a26, .bin, .rom, gz, or .zip Atari 2600 ROM files.<br />
<br />
Connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", "ringtones", and most importantly, a "stella" folder. Click on that and therein the "roms" folder. Copy the ROMs from your computer and move them here. Just put the files there, do not create subdirectories.<br />
<br />
==Controls==<br />
If you have installed some ROM files, start Stella, you will see a list of games available. Select one by tapping on it and tap on the "select" button in the bottom left corner - the game starts.<br />
<br />
Here is the default Keymapping coming with Stella:<br />
<br />
* up w<br />
* down s<br />
* left a<br />
* right d<br />
* jump space (originally called fire1 too)<br />
* fire2 f<br />
* fire3 g<br />
* select enter<br />
* reset q<br />
* save shift<br />
* load l<br />
* take screenshot p<br />
* options-menu delete<br />
* command-menu c<br />
<br />
==The most important things to know==<br />
<br />
* ''start game'': pres space bar<br />
* ''move around'': use w,s,a,d keys (see above)<br />
* ''fire/jump'': pres spacebar<br />
* ''switch to landscape mode'': press Delete on keyboard => tap "UI Settings" => tap "Fullscreen" => select "off" => tap button "Ok"<br />
* ''modify keymappings'': press Delete on keyboard => tap "Input Settings" => select a function (current mapping will be displayed below!) => tap "Map" => press the new key => tap "Ok"<br />
* ''take screenshot'': press "p", screenshots will be saved to "/media/internals/stella/screenshots/"<br />
* ''exit current game/return to ROM Launcher'': press "c" key => tap "Exit Game"<br />
* ''exit Stella'': throw it away OR tap "Quit" in ROM Launcher<br />
<br />
==Screenshots==<br />
<gallery><br />
Image:Stella_About.png<br />
Image:Stella_Settings.png<br />
Image:Crazy_Climber_(1982)_(Atari).png<br />
Image:Demon_Attack_(1982)_(Imagic).png<br />
Image:Mario_Bros._(1983)_(Atari).png<br />
</gallery><br />
<br />
== Feature Requests/TODO ==<br />
<br />
==Known issues==<br />
* Stella crashes if you switch from portrait mode (the default) to landscape mode. Open bug reported to stella maintainer (debilater)<br />
* taking screenshots with the palm (orange+@+p) produces empty images<br />
* if you put stella into the background, the command menu appears<br />
<br />
== Changelog ==<br />
* '''0.0.1'''<br />
** Initial version (stella 3.0 stable)</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Application:Stella&diff=8984Application:Stella2010-02-09T20:54:53Z<p>Debilater: /* Known issues */</p>
<hr />
<div>=Stella Atari 2600 VCS Emulator 3.0=<br />
[[Image:Stella_icon.png]]Stella is a multi-platform Atari 2600 VCS emulator released under the GNU General Public License (GPL).<br />
<br />
=Credit=<br />
Ported by [http://www.daemon.de/PalmPre Thomas Linden (debilater)] February 2010.<br />
<br />
=License=<br />
All source is under the GPL license.<br />
The original source code is available [http://stella.sourceforge.net/downloads.php here]<br /><br />
And the latest "Stella Atari 2600 VCS Emulator" for webOS source is available on git [http://git.webos-internals.org/?p=games/stella.git here] <br /><br />
<br />
== Installing VBA ==<br />
Install [[Preware]], and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "stella" (no quotes). Stella should show up. If not, make sure your feeds are up to date. Click on Stella and then click install. You will probably have to install other services as well (it will tell you if you do).<br />
<br/><br />
<br />
Now you are ready to add ROMs(games)!<br />
<br />
==Adding ROMS==<br />
We aren't going to discuss how to get ROMs here but we will tell you how to transfer them to your Pre.<br />
<br />
You may use .a26, .bin, .rom, gz, or .zip Atari 2600 ROM files.<br />
<br />
Connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", "ringtones", and most importantly, a "stella" folder. Click on that and therein the "roms" folder. Copy the ROMs from your computer and move them here. Just put the files there, do not create subdirectories.<br />
<br />
==Controls==<br />
If you have installed some ROM files, start Stella, you will see a list of games available. Select one by tapping on it and tap on the "select" button in the bottom left corner - the game starts.<br />
<br />
Here is the default Keymapping coming with Stella:<br />
<br />
* up w<br />
* down s<br />
* left a<br />
* right d<br />
* jump space (originally called fire1 too)<br />
* fire2 f<br />
* fire3 g<br />
* select enter<br />
* reset q<br />
* save shift<br />
* load l<br />
* take screenshot p<br />
* options-menu delete<br />
* command-menu c<br />
<br />
==The most important things to know==<br />
<br />
* ''start game'': pres space bar<br />
* ''move around'': use w,s,a,d keys (see above)<br />
* ''fire/jump'': pres spacebar<br />
* ''switch to landscape mode'': press Delete on keyboard => tap "UI Settings" => tap "Fullscreen" => select "off" => tap button "Ok"<br />
* ''modify keymappings'': press Delete on keyboard => tap "Input Settings" => select a function (current mapping will be displayed below!) => tap "Map" => press the new key => tap "Ok"<br />
* ''take screenshot'': press "p", screenshots will be saved to "/media/internals/stella/screenshots/"<br />
* ''exit current game/return to ROM Launcher'': press "c" key => tap "Exit Game"<br />
* ''exit Stella'': throw it away OR tap "Quit" in ROM Launcher<br />
<br />
==Screenshots==<br />
<gallery><br />
Image:Stella_About.png<br />
Image:Stella_Settings.png<br />
Image:Crazy_Climber_(1982)_(Atari).png<br />
Image:Demon_Attack_(1982)_(Imagic).png<br />
Image:Mario_Bros._(1983)_(Atari).png<br />
</gallery><br />
<br />
== Feature Requests/TODO ==<br />
<br />
==Known issues==<br />
* Stella crashes if you switch from portrait mode (the default) to landscape mode. Open bug reported to stella maintainer (debilater)<br />
* taking screenshots with the palm (orange+@+p) produces empty images<br />
* if you put stella into the background, the command menu appears<br />
<br />
== Changelog ==<br />
* '''0.0.1'''<br />
** Initial version (stella 3.0 stable)</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=Application:Stella&diff=8982Application:Stella2010-02-09T20:41:34Z<p>Debilater: initial stella app page</p>
<hr />
<div>=Stella Atari 2600 VCS Emulator 3.0=<br />
[[Image:Stella_icon.png]]Stella is a multi-platform Atari 2600 VCS emulator released under the GNU General Public License (GPL).<br />
<br />
=Credit=<br />
Ported by [http://www.daemon.de/PalmPre Thomas Linden (debilater)] February 2010.<br />
<br />
=License=<br />
All source is under the GPL license.<br />
The original source code is available [http://stella.sourceforge.net/downloads.php here]<br /><br />
And the latest "Stella Atari 2600 VCS Emulator" for webOS source is available on git [http://git.webos-internals.org/?p=games/stella.git here] <br /><br />
<br />
== Installing VBA ==<br />
Install [[Preware]], and then launch it. Click on "Available Packages" then "Applications, or "Available Applications" then "All" depending on the Preware preferences you have chosen. Now type in "stella" (no quotes). Stella should show up. If not, make sure your feeds are up to date. Click on Stella and then click install. You will probably have to install other services as well (it will tell you if you do).<br />
<br/><br />
<br />
Now you are ready to add ROMs(games)!<br />
<br />
==Adding ROMS==<br />
We aren't going to discuss how to get ROMs here but we will tell you how to transfer them to your Pre.<br />
<br />
You may use .a26, .bin, .rom, gz, or .zip Atari 2600 ROM files.<br />
<br />
Connect your Pre to your computer via USB mode. Once the Pre shows up on your computer, open it. You now should be at the "root" of your Pre's storage. If you look at the folders in the root, there should be a few including the "wallpapers", "ringtones", and most importantly, a "stella" folder. Click on that and therein the "roms" folder. Copy the ROMs from your computer and move them here. Just put the files there, do not create subdirectories.<br />
<br />
==Controls==<br />
If you have installed some ROM files, start Stella, you will see a list of games available. Select one by tapping on it and tap on the "select" button in the bottom left corner - the game starts.<br />
<br />
Here is the default Keymapping coming with Stella:<br />
<br />
* up w<br />
* down s<br />
* left a<br />
* right d<br />
* jump space (originally called fire1 too)<br />
* fire2 f<br />
* fire3 g<br />
* select enter<br />
* reset q<br />
* save shift<br />
* load l<br />
* take screenshot p<br />
* options-menu delete<br />
* command-menu c<br />
<br />
==The most important things to know==<br />
<br />
* ''start game'': pres space bar<br />
* ''move around'': use w,s,a,d keys (see above)<br />
* ''fire/jump'': pres spacebar<br />
* ''switch to landscape mode'': press Delete on keyboard => tap "UI Settings" => tap "Fullscreen" => select "off" => tap button "Ok"<br />
* ''modify keymappings'': press Delete on keyboard => tap "Input Settings" => select a function (current mapping will be displayed below!) => tap "Map" => press the new key => tap "Ok"<br />
* ''take screenshot'': press "p", screenshots will be saved to "/media/internals/stella/screenshots/"<br />
* ''exit current game/return to ROM Launcher'': press "c" key => tap "Exit Game"<br />
* ''exit Stella'': throw it away OR tap "Quit" in ROM Launcher<br />
<br />
==Screenshots==<br />
<gallery><br />
Image:Stella_About.png<br />
Image:Stella_Settings.png<br />
Image:Crazy_Climber_(1982)_(Atari).png<br />
Image:Demon_Attack_(1982)_(Imagic).png<br />
Image:Mario_Bros._(1983)_(Atari).png<br />
</gallery><br />
<br />
== Feature Requests/TODO ==<br />
<br />
==Known issues==<br />
* Stella crashes if you switch from portrait mode (the default) to landscape mode. Open bug reported to stella maintainer (debilater)<br />
<br />
<br />
== Changelog ==<br />
* '''0.0.1'''<br />
** Initial version (stella 3.0 stable)</div>Debilaterhttp://wiki.webos-internals.org/index.php?title=File:Mario_Bros._(1983)_(Atari).png&diff=8981File:Mario Bros. (1983) (Atari).png2010-02-09T20:37:48Z<p>Debilater: </p>
<hr />
<div></div>Debilaterhttp://wiki.webos-internals.org/index.php?title=File:Demon_Attack_(1982)_(Imagic).png&diff=8980File:Demon Attack (1982) (Imagic).png2010-02-09T20:37:25Z<p>Debilater: </p>
<hr />
<div></div>Debilaterhttp://wiki.webos-internals.org/index.php?title=File:Crazy_Climber_(1982)_(Atari).png&diff=8979File:Crazy Climber (1982) (Atari).png2010-02-09T20:37:04Z<p>Debilater: </p>
<hr />
<div></div>Debilaterhttp://wiki.webos-internals.org/index.php?title=File:Stella_Settings.png&diff=8978File:Stella Settings.png2010-02-09T20:36:44Z<p>Debilater: </p>
<hr />
<div></div>Debilater