Related
The Andrinux-Project - bringing GNU/Linuxux to your phone
I've put the whole thing onto github because it's too much for me alone. I need your help: http://forum.xda-developers.com/showthread.php?p=30207959
{
"lightbox_close": "Close",
"lightbox_next": "Next",
"lightbox_previous": "Previous",
"lightbox_error": "The requested content cannot be loaded. Please try again later.",
"lightbox_start_slideshow": "Start slideshow",
"lightbox_stop_slideshow": "Stop slideshow",
"lightbox_full_screen": "Full screen",
"lightbox_thumbnails": "Thumbnails",
"lightbox_download": "Download",
"lightbox_share": "Share",
"lightbox_zoom": "Zoom",
"lightbox_new_window": "New window",
"lightbox_toggle_sidebar": "Toggle sidebar"
}
At first big thanks to dudumomo for hosting the project! I can't thank you enough!
Then big thanks to TylerDurben for the awesome picture work!
Please: Learn to read the whole opening post!
I won't help in cases like this anymore! All informations are given!
Thanks!
Note: it doesn't boot a phony-Linux! This Linux runs on top of Android!
"Hey Nerds!" would Sassibo(o)b say.
But I'll say:
Hey dudes!
Welcome to the Andrinux-Project.
What the heck is Andrinux?!
Andrinux is a project (inspired by LeeDroid) to bring GNU/Linux to your phone!
Started in summer 2011 I now got the first running build for you.
Why should I use Andrinux?
Why are you thinking I can answer this question for you?!
It's your decision!
I use it for things like git and office apps.
trh1341 said:
Just want to prove that this is awesome...the ics rom by me and Jcmaddox...most of that was done using this because my computer has a broken screen
Sent from my HTC Inspire "4G" using Ice Cream Sandwich
Click to expand...
Click to collapse
Why are you posting it here and not in the general Android development?
Because I only tested it on the Desire HD and on no other device. But maybe later.
Why aren't you coming to the interesting thing - the download?
Ok, ok. I'm gonna hurry.
Disclaimer:
If something goes wrong or if something gets broken I'm not responsible for this!
Pay for it on your own!
What you'll need:
-phone
-PC or Mac
-unpacker for 7z-archives
-root
-S-OFF
-system read/write enabled (with newest update not needed anymore. If the script fails your should use this app)
-busybox
-SD-Card
-3 GB of free space on the SD-Card
-kernel with loop-support
-time
How to:
Let's get to the real thing.
First download the desired distribution.
Unpack the whole thing to your SD-Card and put it in your phone.
When you got there open a terminal emulator and switch to root mode.
Then you could follow the README-file but I made a little mistake while saving.
Please make sure to mount the system read/write!
So here the instructions:
Type in:
Code:
cd /mnt/sdcard/andrinux/???
sh prepare.sh
boot-???
Codes for the ???:
cd-codes:
debian
fedora
slack
ubuntu
boot-codes
sque- Debian Squeeze- available
whe- Debian Wheezy- not available
fed13- Fedora 13- not available
fed14- Fedora 14- not available
slack- Slackware- not available
nat- Ubuntu Natty- not available
one- Ubuntu Oneiric- available
What you'll get:
The distribution, in most cases with xfce 4 and VNC server.
What you should do after entering GNU/Linux:
Update your distribution and install wanted software like a browser.
I suggest Midori, which you can see in the pictures.
It's pretty fast on a phone.
What you shouldn't do:
rm -r /
Tips:
More than 255 apps on SD aren't possible on our phone in combination with Andrinux, sorry.
If you want an other resolution you can edit the xstart-file in your andrinux/debian-folder.
Then run sh prepare.sh again.
I already added the locate-command and updated the database. So you can simply use it.
For more details see the tutorial in the next post.
Please, don't use the xterm.
Use the terminal emulator which you're running in the background instead. xterm is full of errors on the phone cause it uses the wrong scripts/files/programs.
You don't need to put "sudo" in front of a command. You are always logged in as root.
The browser I use can be installed with
Code:
apt-get install midori
You may use Iceweasel, the Debian-Firefox (better compatibility). Install it with
Code:
apt-get install iceweasel
Use your volume keys to scroll faster on GUI with Android VNC.
You're an Andrinux-User?
Show it to others!
Take this link:
http://andrinux.freelydifferent.com/img/user.png
Want the official Andrinux wallpaper?
Look here!
How it works:
First, it sets the img-file located in the folder andrinux/??? on your SD-Card as a device.
Then it mounts the device.
After that we enter the environment of your distribution.
As this happens, we also switch to the distribution-bash and viola - we got GNU/Linux.
Cause every change is made like in a virtual machine, everything will be saved to your img-file on your SD-Card and your ROM files won't get touched.
The thanks-button is often overlooked.
Please use it if you like Andrinux.
Thanks.
Download section
Please no mirrors! I want to see how many downloads which one gets and want to earn a little amount of money! Thank you!
Everythings right now, have fun.
Debian Squeeze - 12.12.2011:
http://andrinux.freelydifferent.com/downloads/debian/deb-sque.7z - size: 456,7 MB
Mirror (Multiupload):
http://www.multiupload.com/K244AYLM7Q
Debian Squeeze update - 09.02.2012:
http://andrinux.freelydifferent.com/downloads/debian/update090212.zip
Ubuntu Oneiric - 02.01.2012:
http://andrinux.freelydifferent.com/downloads/ubuntu/ubu-one.7z - size: 540,2 MB
Mirror (Multiupload):
http://www.multiupload.com/TEH2Q1JHRH
Ubuntu Oneiric update - 09.02.2012:
http://andrinux.freelydifferent.com/downloads/ubuntu/update090212.zip
Changelog section
Debian Squeeze:
14.12.2011:
-got it working with App2SD up to 99 apps
-SD-Card bind in Linux environment
-no more fail-mounts (mounting / instead of the image)
-tutorial added
-changed resolution for VNC to 800x480
15.12.2011:
-little ad-remove-correction
-added shortcut for SD-Card to Desktop
-corrected nameserver-problem ("couldn't resolve ...) - thx to Floep
24.12.2011:
-new script created from scratch
-up to 255 apps on SD-Card possible
01.01.2012:
-better script structure
-fixed a big which shouldn't appear
04.01.2012:
-more customizable xstart-script (run "xstart 800x600 for example to get this resolution)
-some tests whether mounting was successful
08.01.12:
-corrected the if-conditions
-added /system read-write to script, no app needed anymore
09.02.12
-added ICS-support - thanks to craigkal
-added some things to make it easier for me to edit the script
-added something which should help to get this working on every device (inspired by adwinp)
-added a hidden feature - to find it, you have to use an option.
Ubuntu Oneiric:
24.12.2011:
-initial release
-added Firefox, Midori and Nautilus as Christmas-special
-new method to install the system: when you run the prepare.sh it'll create the image for you and unpack the system - less to upload, less to download.
29.12.2011:
-biggest problem (creation of image failed) fixed
-script is now more friendly for the ones who want to adjust it.
-big security hole (filing your /data partition when the image isn't mounted) got fixed
02.01.2012:
-new release (should now really work for everyone )
04.01.2012:
-more customizable xstart-script (run "xstart 800x600 for example to get this resolution)
-some tests whether mounting was successful
08.01.2012
-corrected the if-conditions
-added /system read-write to script, no app needed anymore
09.02.12
-added ICS-support - thanks to craigkal
-added some things to make it easier for me to edit the script
-added something which should help to get this working on every device (inspired by adwinp)
-added a hidden feature - to find it, you have to use an option.
-new script for Ubuntu by adwinp. Take this for it. https://www.box.net/shared/ncrs2o8i5lc6vj7pgpxy
Credits:
Code:
echo "I: New script from scratch. So only credits to me. :P"
echo "I: Already ad-cleaned by the Andrinux-Project. ;)"
Troubleshooting:
http://forum.xda-developers.com/showpost.php?p=20733038&postcount=107
Any more questions?
Post them here.
If you want the latest updates you can follow me on Twitter!
http://twitter.com/Ditti4
If you have problems and need help:
Gtalk - [email protected]
Please tell me your XDA-username so I can identify you.
Step-by-step guides
Video tutorials:
Debian Squeeze
(Thanks, Peat. )
Written tutorials:
Debian Squeeze:
1. Step:
Download the two files from the download section and unpack them.
2. Step:
You'll see a folder named andrinux and four new files (xstart,xexit, prepare.sh and boot-sque).
Put these four files into the debian-folder in the andrinux-folder by replacing the existing ones.
3. Step:
Put the andrinux-folder to the root of your SD-Card.
To do so: plug in your phone and switch to Mass-Storage-Mode.
Then copy and paste it to the SD-Card.
4. Step:
Let's switch to the phone.
Got busybox installed? If not, look into the requirements.
Got a terminal emulator installed? If not install one from the Market.
5. Step:
Open terminal emulator and type in
Code:
su
to switch to root mode.
Now type in
Code:
cd /mnt/sdcard/andrinux/debian
to change to the Debian directory.
Then type
Code:
sh prepare.sh
to prepare your system.
Got this? Perfect!
6. Step:
Type in
Code:
boot-sque
to power Debian up.
You'll see
Code:
[email protected]
at the beginning of the line.
7. Step:
Wanna see something graphical?
Install "Android VNC" from the Market.
Then go back to terminal and type in
Code:
xstart
and now launch Android VNC.
Now the connect settings:
Code:
Server: localhost
Port: 5901
Password: andrinux
Now the desktop should appear.
Tip:
Want a web browser?
Code:
apt-get install midori
for a lightweight one and
Code:
apt-get install iceweasel
for something Firefox-like (Ubuntu installs the original Firefox with this command).
8. Step:
Want to end your season?
Choose the disconnect-option in Android VNC and switch back to the terminal.
Now type in
Code:
xexit
to stop the desktop and then
Code:
exit
to shut down Debian.
Ubuntu Oneiric:
1. Step:
Download the file from the download section and unpack it.
2. Step:
You'll see a folder named andrinux and four new files (xstart,xexit, prepare.sh and boot-one).
Put these four files into the ubuntu-folder in the andrinux-folder by replacing the existing ones.
3. Step:
Put the andrinux-folder to the root of your SD-Card.
To do so: plug in your phone and switch to Mass-Storage-Mode.
Then copy and paste it to the SD-Card.
4. Step:
Let's switch to the phone.
Got busybox installed? If not, look into the requirements.
Got a terminal emulator installed? If not install one from the Market.
5. Step:
Open terminal emulator and type in
Code:
su
to switch to root mode.
Now type in
Code:
cd /mnt/sdcard/andrinux/ubuntu
to change to the Ubuntu directory.
Then type
Code:
sh prepare.sh
to prepare your system.
6. Step:
Type in
Code:
boot-one
to power Ubuntu up.
You'll see
Code:
[email protected]
at the beginning of the line.
7. Step:
Wanna see something graphical?
Install "Android VNC" from the Market.
Then go back to terminal and type in
Code:
xstart
and now launch Android VNC.
Now the connect settings:
Code:
Server: localhost
Port: 5901
Password: andrinux
Now the desktop should appear.
Tip:
Want a web browser?
Code:
apt-get install midori
for a lightweight one and
Code:
apt-get install iceweasel
for Firefox.
8. Step:
Want to end your season?
Choose the disconnect-option in Android VNC and switch back to the terminal.
Now type in
Code:
xexit
to stop the desktop and then
Code:
exit
to shut down Ubuntu.
Any problems?
Ask me!
Dayummmmmmmmmmmmmmmm, neat stuff. I might try it when i have the time to
great job,just in time,i am bored ,what distribution do u prefer ?
evanbigfan said:
what distribution do u prefer ?
Click to expand...
Click to collapse
Cause I'm addicted to Ubuntu/Debian and the Ubuntu-arm-port isn't the best I'm using Debian.
But that's totally personal.
And what you see above is the Debian build.
Sent from my loved HTC Desire HD @MIUI Germany <3
Ditti4 said:
Cause I'm addicted to Ubuntu/Debian and the Ubuntu-arm-port isn't the best I'm using Debian.
But that's totally personal.
And what you see above is the Debian build.
Sent from my loved HTC Desire HD @MIUI Germany <3
Click to expand...
Click to collapse
thanks,it will be the first then,another thing,when i reboot the device i'll went back to my rom right,and any changes i made to the linux will go or remain ?
evanbigfan said:
thanks,it will be the first then,another thing,when i reboot the device i'll went back to my rom right,and any changes i made to the linux will go or remain ?
Click to expand...
Click to collapse
The Linux is on a external virtual partition on your SD-Card. So any change will remain until you delete the .img-file.
And yes, you'll went back to your ROM. Gonna add some more info to the opening post.
Sent from my loved HTC Desire HD @MIUI Germany <3
Great job, I'm waiting for test it.
one question: all part of device ( camera wifi blue 3g) work's or booting only?
Doesn't this open opportunities for other OS's like WP7?
Correct me if I am wrong.
BTW: Amazing job man
homerino85 said:
Great job, I'm waiting for test it.
one question: all part of device ( camera wifi blue 3g) work's or booting only?
Click to expand...
Click to collapse
I think you misunderstood me.
It's running on top of Android.
You'll get a fully working Android and on top of it a nearly fully working GNU/Linux.
H-Streety said:
Doesn't this open opportunities for other OS's like WP7?
Correct me if I am wrong.
BTW: Amazing job man
Click to expand...
Click to collapse
Nope, cause it runs on top of Android.
Added a note to the top to avoid questions like this.
But as the time goes by and we'll get a Windows 8 ARM version, we can maybe run this on our phones.
But since Windows Phone 7 isn't open source, we'll never be able to run it on an Android phone...
Sent from my loved HTC Desire HD @MIUI Germany
Ditti4 said:
The Linux is on a external virtual partition on your SD-Card. So any change will remain until you delete the .img-file.
And yes, you'll went back to your ROM. Gonna add some more info to the opening post.
Sent from my loved HTC Desire HD @MIUI Germany <3
Click to expand...
Click to collapse
that what i thought ,thanks
Just added Debian Squeeze.
Have fun!
Sent from my loved HTC Desire HD @MIUI Germany <3
All those sounds to good to be true
Hope i get some time in this evening to test it.
Is it possible to start backtrack with andrinux?
Did it work with all android roms?
What about ICS?
Cant wait for testing ...... big thx for.making this possible
Sent from my Desire HD using XDA App
TylerDurben said:
All those sounds to good to be true
Hope i get some time in this evening to test it.
Is it possible to start backtrack with andrinux?
Did it work with all android roms?
What about ICS?
Cant wait for testing ...... big thx for.making this possible
Sent from my Desire HD using XDA App
Click to expand...
Click to collapse
Backtrack should be possible, give me some time.
Haven't got the fastest internet.
ICS... Good question.
If I get a running Terminal Emulator for ICS I'm gonna test it.
Ditti4 said:
Backtrack should be possible, give me some time.
Click to expand...
Click to collapse
It's probably worth mentioning here that even if Backtrack works (and I think it should) it won't be possible to use something like aircrack-ng or anything that needs Promiscuous/Monitor Mode and/or Injection.
This is awesome! I assume it will work on the Inspire 4G as well? If so I can't wait to try it out!
MusikMonk said:
It's probably worth mentioning here that even if Backtrack works (and I think it should) it won't be possible to use something like aircrack-ng or anything that needs Promiscuous/Monitor Mode and/or Injection.
Click to expand...
Click to collapse
This should be worth a try.
gtalum said:
This is awesome! I assume it will work on the Inspire 4G as well? If so I can't wait to try it out!
Click to expand...
Click to collapse
Should also work on it but I can't prove it cause I only got the DHD.
Sent from my loved HTC Desire HD @MIUI Germany <3
Ditti4 said:
Should also work on it but I can't prove it cause I only got the DHD.
Click to expand...
Click to collapse
I'll give it a try soon and let you know.
m getting an error in terminal emulator ..
here is what i did
su
cd /sdcard/andrinux/debian
sh prepare.sh
then got an error (screenshot attached)
riteshbendre said:
m getting an error in terminal emulator ..
here is what i did
su
cd /sdcard/andrinux/debian
sh prepare.sh
then got an error (screenshot attached)
Click to expand...
Click to collapse
Please always read the opening post carefully.
From "What you'll need":
Ditti4 said:
-/system read/write
Click to expand...
Click to collapse
There are some apps out there to do this. Search on the Market for "remount".
Sent from my loved HTC Desire HD @MIUI Germany
(I'm reposting this under a different title so web searches will bring it up)
I can get Ubuntu 11.04, 11.10 & Debian 6 to mount repeatedly in all sorts of ui updatable configurations using this information:
http://www.nerd65536.com/2011/07/ins...version-2.html
It's a friggin Christmas Miracle! Can't tell you how much time I've wasted working this out, and it all boils down to the sh and run scripts.
So, without further ado, here goes.
!!Make sure you're rooted!!
!!The quotes just tell you what to type. Don't type them!!
1.
Download one of the three builds on the website listed above (or build your own, it should work fine). Extract it from tar.bz2, they should all extract to a linux file, this includes the necessary scripts. Put it on the sd-card on your phone.
2.
Download the new scripts that (Nerd) listed found here: http://ohm.nerd65536.com/android-lin...latest.tar.bz2
And extract them. You'll have another file that says linux. Open it, take the three files inside (install.sh, root-scripts & scripts) and paste them in the linux folder you moved to your sd-card. They will overwrite the ones currently there. These scripts work for sgs4g, the originals did not.
3.
Install the latest BusyBox in both xbin and .bin if it's not already installed (must be rooted), Latest is 1.19.3. Make sure Outside Sources and USB debugging are both enabled in your settings menu. Open your Superuser App and update binaries.
4.
Download a terminal client, like Better Terminal Emulator or Android Terminal Emulator. I use the first. The terminal needs to run the commands as root, especially the linux vnc command as it didn't want to work for me no matter if I started by typing su. Better Terminal Emulator has a check box to always start in root.
5.
Open up your terminal emulator and type su if you are not rooted there. Then change directory to the linux file on the sd-card. run the sh file there.
Like this:
"su"
"cd /sdcard/linux"
"sh install.sh"
If it works, the resulting dialog in terminal won't throw up any problems.
6.
Get back to / on sd by typing in terminal:
"cd /"
You should then have a: / # prompt, which means you are still rooted.
Enter:
"linux"
Which should result in a: [email protected]:/#
This means Linux is running. Congratulations. It should continue to run unless you shut down your phone.
7.
Download a VNC client, like Android VNC Viewer (free) or Remote VNC Pro, which I use. Add a new entry in it, with the following settings:
Host: localhost
Port: 5901
Password: cheesecake
Color: 24-bit
Name: Linux
When that's done save if you can or back out if you can't, and go back to your terminal emulator.
8.
It should still say: [email protected]:/#
If it doesn't, fine, if it does, just go back to root prompt by typing:
"exit"
Which should get you: / #. Then type:
"linux vnc"
Which should run itself and mount the chroot environment. It should tell you your new 'X' desktop is localhost:1, and have a: / # prompt again.
It might also ask you for a password, if so then put whatever password you'll remember in that's longer than 6 characters and verify it. This only happens once.
9.
Go back to your VNC client and if you entered a password in step 8. then edit your listing to your password instead of cheesecake, if not then don't.
Click on the Linux link and BAM! (shameless Emerilism), you're at your Linux desktop which should be running a iceWM desktop interface, which is fast. The LXDE desktop is nicer and if you want that then go into you're terminal and get into the linux shell by typing:
"linux"
And then switch to LXDE by typing:
"apt-get autoremove icewm- lxde+"
Which will run through the removal/ installation, and verify you want to download the <400mb files. Type:
"y"
And give it time to finish. When finished, just go back to your VNC client and hit Linux again, and you will have a nice looking functional desktop, with a cpu load graph on the bottom. I tried using Gnome desktop and Unity 2d, but both of these would install and not fully run with all options. They are heavier and slower, but cool non-the-less. Let me know if anyone has luck with these on Android.
Notes-
You only have to type "linux vnc" once in terminal to start linux every time you boot your phone. Otherwise, just open your VNC client and click on Linux to use it. Easy!
You will want to update and upgrade your linux after install, do so by typing in terminal:
"apt-get update"
"apt-get upgrade"
Also, you might run across a problem if you try to add-apt-repository, that's because that python command is not present. To use it, enable by typing:
"apt-get install python-software-properties"
Also of note, the downloadable linux builds are sized to about 2.15gig on your sd, which is big enough for most. There is a way to resize them which I tried but it gave me trouble in loading. I will try again and see if I can get it to work.
Here's the link from Dangermouse:
http://www.androidfanatic.com/commun...atid=9&id=1610
Thanks to Nerd65536 for the info, write-up and files. He fixed my problem.
You might want to put quote or code tags around all the commands to make them easier to see and read, but good guide! I'll try it out soon since I haven't gotten any linux build to run on my phone in a good while.
Thanks for the post!
I wrote the post noob-style to make it easy for beginners to follow, as I've had to search and test forever to find information that works.
Let me know if you have any problems, I'd be happy to assist. Don't expect you'll have any issues with your knowledge of the os. It works pretty well on the Android system, fun to use.
wasn't this posted ages ago?
No, it's a bleed over from a question post I made under Q&A a week or so ago. I threaded this because I had such a hard time finding a thread with working steps for the Galaxy S under google search. There's not that much new from this post http://www.nerd65536.com/2011/07/in...showComment=1323566336074#c553594301247543088 by Nerd65536 (which took me forever to find and was the only one that worked). Other than that, just a few of my own thoughts and hints on the process.
krylon360 said:
wasn't this posted ages ago?
Click to expand...
Click to collapse
meant to quote not thanks, but anyways, to answer.
There has been a few times this has been posted, but its been many months and this seems like the first the issues have been sorted.
Sent from my SGH-T959V using Tapatalk
Ok, a little more use of Linux builds on my phone and I'm starting to understand why it does or does not work.
Certain kernel builds seem to work well, others not at all. Most of the kernel's I've tried have been problematic, and trying to install the .sh file will fail.
When you install your new kernel (or on your existing one) you need to open your Superuser app which should be there if your phone is rooted. There is a button to update binaries, and they need to be updated. Some builds don't seem to let this work easily and give failure notifications.
Make sure Outside Sources is enabled and USB debugging is too, both are in the settings menu.
Use BusyBox installer to install in both the .bin and .xbin directories, this will not cause any conflicts (or hasn't yet . If this gives you an error, and it will if Superuser did, then either usb debugging has not been selected or the kernel is not playing nice.
Ok, so this kernel by RaverX3X will work for linux, I'm on it now:
http://forum.xda-developers.com/showthread.php?t=1305145
(Thanks for this)
Oh yeah, and Back|Track5 Linux is working too
Fixing the packet injection for the Broadcom now.
sconsylman said:
Oh yeah, and Back|Track5 Linux is working too
Fixing the packet injection for the Broadcom now.
Click to expand...
Click to collapse
. Keep us posted on that. Should be pretty handy.
Wait. why do we need LInux to run on our phone?
Can someone explain?
Android doesn't come with most of what this has:
http://www.backtrack-linux.org/
I know, but why do we need it?
Enlighten me
airfluip1 said:
Wait. why do we need LInux to run on our phone?
Can someone explain?
Click to expand...
Click to collapse
I've seen this comment on every single thread online regarding Linux on Android. It's a joke right?
I went on and ported from scratch (not using work done for the i9000) Ubuntu Touch for our magic samsung captivate! The port itself is just the base of CyanogenMod to be able to support the binary blobs (drivers) of various devices without having to rewrite them (source code is usually not avaliable). Mine is the i897 ATT variant.
I wanted to post the link to the rom from my google drive, but since i just registered here to post this I cannot post external links. PM me and i will send the link to you ASAP!!
Installation instructions:
1- Copy the CM_BASE_UBUNTU_TOUCH zip file to the phone (internal or external sd doesn't matter)
2- Download the latest image of Ubuntu Touch from the ubuntu website. The current filename is quantal-preinstalled-phablet-armhf.zip (This will change once the builds are based on Raring - 13.04 - and not Quantal - 12.10): PM ME FOR LINK OR SEARCH GOOGLE FOR "UBUNTU TOUCH DAILY"
3- Copy the Ubuntu Touch image to the phone
4- Reboot into recovery
5- Install CM_BASE_UBUNTU_TOUCH.zip from sd
6- Wipe Cache
7- Wipe Data partition
8- Install Ubuntu Touch zip from sd card
9- Patiently wait
10- Reboot and Enjoy!
EDIT--> Now you have the system 90% ready, but for the resolution of our device and the size of our screen we will have to change some parameters to fix the dpi and scaling:
EDIT 2 --> All these steps are unneccessary if you flash http://goo.im/devs/pawitp/galaxysmtd...x-20130223.zip after everything else. Thanks go to Citrit who pointed out the post in the i9000 ubuntu touch thread http://forum.xda-developers.com/showthread.php?t=2162534
If you want to go through how it is done, or if you want to play with the settings, follow on. If not, jump past the F.
11- While the device is on, connect to your computer via usb
12- From a terminal, run the following commands
A- adb root (necessary to be able to enter directly into a root adb shell)
B- adb shell (we are based on cyanogen, so our lovely adb commands still work)
C- ubuntu_chroot shell (to enter a linux command prompt, since ubuntu is a layer on top of the android linux kernel)
D- vi /usr/bin/ubuntu-session (edit the session configuration. I used vi but feel free to do however you like)
E- Here near the beginning you will find a series of preconfigurations for some devices and a generic one at the end: this is the one we have to edit. The GRID_UNIT_PX parameter with 18 as a value has to be changes to 11 or 12 (test and see how you like it), and the QTWEBKIT_DPR parameter with 2.0 has to be changed to 1.1 or 1.2
F- you can reboot directly from the chroot session typing "reboot" (without the quotes)
Taken from the Ubuntu Touch porting guide:
you can use adb port forwarding to easily connect to the container via SSH over USB. To do so, run the following commands:
adb forward tcp:8888 tcp:22
ssh [email protected] -p 8888
Currently the power button does not work with recent kernels, so one of the following options must be run:
remove the battery and replace it
run "reboot -p" from the adb shell
adb root
adb shell reboot -p
If you appreciate my work, leave feedback! If you don't, leave feedback! All feedback is welcome! I'd like to know your thoughts, experiences and what bugs or annoyances you encounter!
P.S If the mods could give me permission to post ouside links (or if they could post it themselves if i pm it to them) we would all be very grateful
What works and what doesnt
Sent from my SGH-I897 using xda app-developers app
What works and what doesn't
No cellular connection (no calls, no sms, no data)
Basic wifi works (password free and wpa network tested, but wep should too)
Camera works
Gpu accelleration works
All the rest is untested
but after installing it will i be able to flash back to android 4.2.2????
Reflash to android
n205des said:
but after installing it will i be able to flash back to android 4.2.2????
Click to expand...
Click to collapse
Sure! All you have to do is reboot into recovery (sending an adb command or using the usual button combination) and reflash your favourite rom from there! I tested with the nightly CyanogenMod and with SlimBean, both 4.2.2, and all went well
krissetto said:
Sure! All you have to do is reboot into recovery (sending an adb command or using the usual button combination) and reflash your favourite rom from there! I tested with the nightly CyanogenMod and with SlimBean, both 4.2.2, and all went well
Click to expand...
Click to collapse
okkkayy!
will try and tell you soon
---------- Post added at 10:01 PM ---------- Previous post was at 09:01 PM ----------
i installed it but i couldnt understand how to change the dpi or the resolution to my phones size.
so can you explain me how to do it correctly?
Adjusting dpi scaling
n205des said:
okkkayy!
will try and tell you soon
---------- Post added at 10:01 PM ---------- Previous post was at 09:01 PM ----------
i installed it but i couldnt understand how to change the dpi or the resolution to my phones size.
so can you explain me how to do it correctly?
Click to expand...
Click to collapse
What we have to do is change a couple of lines in the ubuntu-session configuration file. It is located, in ubuntu, in /usr/bin/ubuntu-session. The way i chose to edit this file was via chroot from my pc.
With the phone powered on, connect it to a computer with ADB installed (install the android sdk if you haven't, i personally use linux but you can on windows and osx too). Then from a terminal run the following commands:
adb root
adb shell
ubuntu_chroot shell
After you have inserted these commands, you will find youself in a chroot session, basically any command you now write executes on the phone as if you ran it from there. So i used a terminal text editor (vi, to be precise, but i assume you can use whatever you prefer) and opened the file with this command:
vi /usr/bin/ubuntu-session
vi was designed decades ago, for keyboards without arrow keys, so to move around read a bit on the page i PM'd you.
What you now have to do is scroll down to where you see the following code:
export GRID_UNIT_PX=18
grep -q QTWEBKIT_DPR /home/phablet/.bashrc
[ $? -ne 0 ] && echo "export QTWEBKIT_DPR=2.0" >> /home/phablet/.bashrc
export QTWEBKIT_DPR=2.0
export FORM_FACTOR="phone"
What you have to change is the 18 and the 2.0, repectively in 11 and 1.1 (play around with slightly different settings to get the feel you prefer).
Save the file and type "reboot" in the terminal.
Your phone will now restart, and load up the UI with the settings you just changed
Let me know if you have problems, when I find some time I'll get back to you
anyone?
Has anybody tried this yet?
Looks good
Everything installed fine, had no issues with that. Only issue I'm having is I can't seem to change the resolution by following the above steps. Ubuntu touch looks good though . WORKS: Wifi, Camera. Will provide more feedback once I get into it more.
Resolution scaling
mitchelldavis said:
Everything installed fine, had no issues with that. Only issue I'm having is I can't seem to change the resolution by following the above steps. Ubuntu touch looks good though . WORKS: Wifi, Camera. Will provide more feedback once I get into it more.
Click to expand...
Click to collapse
What problems do you encounter? I noticed that trying to edit the file with nano wouldn't let me save it, as if the command just wouldn't go through, but maybe that was just me.
Everything worked great for me, and the latest build fixes the need for an open Wifi. It now prompts for a password. Here is a fix for the layout, it was taken from this thread:
http://forum.xda-developers.com/showthread.php?t=2162534
Grab the file http://goo.im/devs/pawitp/galaxysmtd_ubuntu/ubuntu-aries-layout-fix-20130223.zip and install this last.
citrit said:
Everything worked great for me, and the latest build fixes the need for an open Wifi. It now prompts for a password. Here is a fix for the layout, it was taken from this thread:
http://forum.xda-developers.com/showthread.php?t=2162534
Grab the file http://goo.im/devs/pawitp/galaxysmtd_ubuntu/ubuntu-aries-layout-fix-20130223.zip and install this last.
Click to expand...
Click to collapse
An easier way to fix it, thanks! I'll edit the orig post with these instructions
When I try to edit the settings using vi it doesnt let me input anything. I get all of the information but cannot edit it.
Editing with vi
mitchelldavis said:
When I try to edit the settings using vi it doesnt let me input anything. I get all of the information but cannot edit it.
Click to expand...
Click to collapse
Have you read the information on how to use vi? There are certain commands to use to edit text, it was built for computer from ages ago, that didn't have many things we're now used to. Excuse me if you are experienced enough to know how to use vi ^^
mitchelldavis said:
When I try to edit the settings using vi it doesnt let me input anything. I get all of the information but cannot edit it.
Click to expand...
Click to collapse
Follow the instruction in the OP about installing a third zip file, then you can safely ignore all the vi instructions.
Sorry if I'm being a dip**** by asking this, but where exactly do I obtain a copy of this "CM_BASE_UBUNTU_TOUCH zip"? I have a captivate begging me for ubuntu touch right now. lol :silly:
can you port to vibrant too
the vibrant is the tmobile version on the captivate can your port to that too. il help with testing:fingers-crossed:
Well from what in seeing I think all u do is flash the nightly of cm10.1 or whatever it is and u should be fine I think his cm_base_Ubuntu_touch thing is his rip from the rom and he's flashing it just as a kernel
Sent from my SGH-I897 using xda app-developers app
this really ought to be in the dev section where it can get the attention and support it deserves...
maybe post to github also...
Is it possible to dual boot my ics jb and ubuntu ? any tutorial ? thanks
Notice (4/16/14): I'm no longer here. I've said "goodbye" to AT&T and their locked bootloader schemes. I'm voting with my wallet - I've sold my I337 and switched to T-Mobile. My apologies to the community, but you're now on your own here.
Intro/About/Requirements:
This thread started as a guide for people who wanted to run Ubuntu in a chroot, and then connecting to it locally with a VNC client. This method has been used countless times on other devices, with many thanks to @zacthespack and his his group, LinuxonAndroid. Unfortunately, this method did not work out-of-the-box on my device, so I tweaked things to work with the Galaxy S4 and posted them here in this thread.
However, the most people immediately noticed that with this method the performance is not great, and some applications can't work in a headless environment. With a comment made by zackthespack, I began researching what it would take to get Ubuntu to write directly to the device's framebuffer. After a few months, I not only managed to accomplish this, but also developed a way to get the Galaxy S4 to boot directly into Ubuntu. As far as I have seen, both of these are a "first" for this handset.
All of these methods require root. The VNC Chroot does not require a custom kernel, but the other methods require a custom-built kernel. For the I337 (AT&T) handset, this can pose a problem if you have bootloaders that are MF3+. If you're using MDB/MDL bootloaders still, you shouldn't have a problem with this and you can Loki the custom kernel without issue.
Depending on your ROM and/or Kernel, you may also need a new version of BusyBox installed, even for the VNC method. You'll find a few apps on the Play Store that can do this for you. Beware that some of them are not easily reversible (such as TinyBox), so if you're stuck on MF3 with no way to create/restore a nandroid/system backup, you should be careful.
Click to expand...
Click to collapse
Disclaimers:
Following this guide and/or flashing anything I've provided to your device is your own responsibility. If something breaks, you break your device, or something explodes, I can't be held liable (I'll help correct any situations you may put yourself in, however). I claim no rights to any proprietary software or intellectual property included in this post or the packages contained herein. By using any of this software, you agree to whatever licenses/agreements that the creators may have included with their software. If you use any of this stuff in your own project, please provide credit where credit is due. For example, if you take my u.sh script and adapt it to some new device (i.e. Galaxy S 5), please at least mention where it came from.
Click to expand...
Click to collapse
VNC Chroot Method (original):
This method is loosely based on this thread for the Galaxy S3 and the ubuntu.sh script there. It didn't work for the S4, but I've made several tweaks to it, simplifying it a ton, and otherwise getting it to work perfectly on my S4. I've tried this using my AT&T Galaxy S4 (SGH-I337) on both the MDL build and the MF3 build - both seem to work great.
Instructions:
Download the Ubuntu 13.04 Small v1 image here.
Create a folder on your sdcard labeled "ubuntu" by whatever means you want to.
Extract the ubuntu.img from your downloaded zip into this folder.
Download my version of the ubuntu.sh and place it on the root of your sdcard.
Open the script in a text editor and read through it. Never run a script like this on your android without first knowing what it does - especially when the author is telling you that you need root. If you're happy with it, proceed.
Install an terminal emulator of your choice. I personally used this one, and technically an adb shell will work too (but you'll be tethered to your PC...).
Install a VNC Client of your choice. I personally used this one, but there might be better/faster ones out there.
Open the terminal emulator, and execute the following commands:
Code:
su
sh /sdcard/ubuntu.sh
If you see a bunch of errors and get dumped back at the "[email protected]:/ # " prompt, then something went wrong. Report your errors in this thread. Remember, this requires root (and the "su" command to get there, of course).
You'll be prompted for some setup parameters, which you can save at the end for later. Just answer each question and press Enter after each:
You'll need to provide a new password for the "ubuntu" user. A simple passwords like "ubuntu" works, unless you want some security.
Start VNC server? (y/n) - always choose "y". We need this to interact with the device.
SSH server? Optional. If you use it, you should enable it.
Screen size: Enter whatever you want. I personally used 960x540 (one quarter of the S4's screen size) so that I could actually interact with things using the touch screen.
Save settings as defaults? - You might not want to do this until you have a screen size that works best for you.
Once you see the prompt, "[email protected]:~# " - you're in! You now have Ubuntu running in a chroot. As the on-screen instructions suggest, type "exit" at this prompt to end the chroot and Ubuntu. It is recommended to do this when you are done so that the ubuntu.sh script can clean up after itself (unmounting things, etc.).
Leave your terminal emulator app running! Use your Home button to return home and leave it running.
Open you VNC client and connect with the following settings:
Nickname: (whatever you want)
Password: ubuntu
Address: localhost
Port: 5900 (default)
Username: (leave blank)
Color Format: 24-bit color (you can use lower if you want better performance)
Connect. For the VNC app I used, I had to zoom in to make the screen fit correctly (use pinch-to-zoom, and then use the "+" button on-screen). Also, you can play around with the Input Mode some if you wish.
Enjoy Ubuntu!
As you can see, it's not terribly complicated to get this up and running. Once you have set it up the first time, it's a lot smoother from then on out. The script is designed to allow you to use the external SDCard if you wish. Just use place the ubuntu.img in an "ubuntu" folder on your external SDCard, drop the ubuntu.sh on the root of the external SDCard, and use "sh /mnt/extSdCard/ubuntu.sh" instead (don't forget "su"!).
Click to expand...
Click to collapse
Freedreno Chroot Method (NEW):
This long-winded tutorial will explain how you can setup Xubuntu-desktop in a chroot. Before attempting any of this, you should read through all the steps and be sure you're comfortable performing the steps needed.
This requires roughly 2GB free space on your /data partition - the actual finished install is about 1.4GB, but it will require some extra space while it installs Freedreno and other components. HINT: Keep in mind that your /data partition is shared with your internal sdcard (your internal sdcard gets whatever space is leftover at the end of the /data partition), so you can get an idea how much free space you have by looking at how much space your internal sdcard has available.
Instructions:
Step 0 (option A) - Build Custom Kernel
You will need to install a custom kernel that has specific options enabled in the configuration, along with a few patched files in the source code. This list of changes is based on a delta from the stock I337 MF3 kernel, available at http://opensource.samsung.com/. You should be able to apply these changes to "any" kernel that you can build from source, so this documentation may apply to devices other than the I337.
Kernel Mods:
Required config changes:
Code:
CONFIG_DEVTMPFS=y
# CONFIG_DEVTMPFS_MOUNT is not set
CONFIG_DRM=y
CONFIG_MSM_KGSL_DRM=y
# CONFIG_KGSL_PER_PROCESS_PAGE_TABLE is not set
# CONFIG_MSM_KGSL_PAGE_TABLE_COUNT is not set
CONFIG_FB_MODE_HELPERS=y
CONFIG_FB_MSM_TRIPLE_BUFFER=y
CONFIG_FB_MSM_DEFAULT_DEPTH_BGRA8888=y
# CONFIG_FB_MSM_DEFAULT_DEPTH_RGBA8888 is not set
Fix for Wi-Fi problems when using MF3 kernel on UCUAMDL bootloaders (i.e. "unadulterated" or "neutered"):
Code:
CONFIG_PROC_AVC=y
Required Patches to kernel source code:
https://github.com/freedreno/kernel-msm/commit/4c0281745f8c85707be88acebb557aca0b8f1dba
https://github.com/freedreno/kernel-msm/commit/228f65d48d4855d903e3b4642179dfa14eedd040
https://github.com/freedreno/kernel-msm/commit/54b510b2e6bccf08fdf3a8ad00a62b27c2f8c1e6
Additional changes required for sudo to work (added 10-25-13 in v4):
Code:
# Samsung Rooting Restriction Feature
#
# CONFIG_SEC_RESTRICT_ROOTING is not set
# CONFIG_SEC_RESTRICT_SETUID is not set
# CONFIG_SEC_RESTRICT_FORK is not set
# CONFIG_SEC_RESTRICT_ROOTING_LOG is not set
Additional changes to the initramfs required for sudo to work (added 10-25-13 in v4):
Edit fstab.qcom, remove the nosuid, part of the line that references userdata.
Step 0 (option B) - Download Custom Kernel Instead
Don't want to compile your own kernel from source? If you have the I337, you can use mine! As mentioned above, this kernel is based on the original MF3 source from Samsung, with the modifications listed above. If you are stuck with MF3+ bootloaders on your I337, you will not be able to install this kernel directly (at the time of this writing). MDB/MDL bootloaders are fine, but you will need to flash loki-doki afterwards (this kernel is not pre-lokified!). This kernel might work with other similar variants (such as the M919), but I haven't tested this on anything except my own I337 daily-driver. YMMV. If you run into issues, you might need to wipe cache/dalvik. This will likely only work with TouchWiz-based ROMs (I have not tried it with AOSP). Here's some downloads for you:
mf3-freedreno-android-boot-v4.zip - CWM/TWRP flashable zip.
- Boots to android, allows Ubuntu with Freedreno to work in a chroot.
- Compiled with the original (slightly modified) MF3 initramfs and "mf3-freedreno-minimum-zImage-v4" (below).
- Includes minimal configuration changes described above, plus the WiFi fix part.
mf3-freedreno-minimum-zImage-v4 - Just the MF3 kernel itself with minimal changes to get the chroot to work.
mf3-freedreno-minimum-config-v4 - Yeah, that's right. I'm providing the .config files I used for all of this.
Step 0.5 - Install the Kernel
Before you can start up the chroot properly, you'll need to have the custom kernel installed. You don't want the "ubuntu-boot" version right now, because you don't have an Ubuntu install to boot to. If you're using my pre-built kernel, first flash mf3-freedreno-android-boot-v4.zip and then flash loki-doki.zip.
Step 1 - Companion Files
Download this file: mf3-freedreno-companions-v4.zip - Non-flashable zip. This includes the script files, which you should promptly read through both u.sh and launch.sh. It is always good practice to read through any script file you get from the internet, making sure it's doing what you would expect it to. Also check out CREDITS.txt, which includes information about the included upstart-dummy.tar.gz and start-stop-daemon files.
Extract the companion files .zip and place its contents on the root of your internal sdcard (/sdcard/). Don't extract the contents of upstart-dummy.tar.gz. This is your $src directory. You can change this if you wish (see script for details).
Step 2 - Install/Configure Ubuntu
Install an terminal emulator of your choice. I personally used this one, and technically an adb shell will work too (but you'll be tethered to your PC...). At the console/shell, type the following two commands:
Code:
su
sh /sdcard/u.sh bash
The script will download Ubuntu Core and install Freedreno, upstart-dummy, and lubuntu-desktop. Total download size will be around 425MB. Total install time will vary, but count on it taking at least 45 minutes to install and configure everything. At the very end, you'll be prompted to enter a password for the new user "ubuntu".
Step 2.5 - Exit ubuntu
When you see the message "Type 'exit' (without quotes) to leave ubuntu," the install is complete. You'll notice that your prompt changed to "[email protected]". This is the easiest way to confirm that you're actually inside the ubuntu chroot. Type exit and hit Enter to get back to android.
Step 3 - Fire it up!
From now on, you can start Ubuntu using u.sh in any of these three ways:
sh /sdcard/u.sh - This will make initial prep, STOP android (black screen), launch the chroot, install/configure if needed, and will execute "service lightdm start". This will give you the greeter and you can login as "ubuntu". If the lightdm service stops for whatever reason (see info about the home button below), the script will continue by exiting the chroot and rebooting your device.
[*]sh /sdcard/u.sh bash - Same as above, except that it will not stop android, not startx (will give bash shell instead), and will not reboot your phone when you exit the shell.
[*]sh /sdcard/u.sh destroy - This will do exactly as it sounds - destroy your ubuntu installation. This will unmount your /sdcard from ubuntu (if still mounted somehow) and then recursively delete your ubuntu installation. If you change the source or destination directories in the main script, you should be careful deleting things.
NOTE: Remember to ALWAYS run any these from a root shell, whether via terminal emulator, via adb shell, or using SManager (or similar).
Step 4 - Note the Home Button and Touchpad
Take note that any time you have X running via lightdm, the hardware Home button will kill the X server. This is intentional, and will exit the chroot and reboot your phone. You'll also notice that currently, the touchscreen acts like a giant touchpad (like on a laptop). Use two fingers to right-click or scroll. Direct touchscreen input is not available at this time due to a segmentation fault that evdev causes when used on this device in a chroot.
Step 5 - (optional) Make Changes and Do it All Over Again
Customize the crap out of it! Edit my u.sh, launch.sh or xorg.conf and have fun. If you find great improvements, please post them in this thread! In future revisions, I might include them. Things should be well documented within the scripts. You might even change the bit at the end of launch.sh that starts "service lightdm start&" instead of "startx" - this would give you the greeter and let you login as the user "ubuntu" if you want. Also note that those three files are the only ones that must remain in your $src directory if you wish to continue to run this as a chroot. By the way, booting directly to Ubuntu after it is installed does not require any of the companion files anymore.
Click to expand...
Click to collapse
Native Boot Method (NEW):
This part of the tutorial is for those who wish to take things a step further and boot your device directly into Xubuntu-desktop. This will require that you setup the Freedreno chroot properly, and then you'll be installing a new boot.img. While this doesn't replace your /system partition, you won't be able to boot directly into Android while you have this boot.img installed.
Instructions:
Step 1 - Install Ubuntu
Basically, you need to perform all the steps for the Freedreno Chroot method, and get that up and running first. All you're doing here is swapping out your kernel.
Step 2 (option A) - Build Custom Kernel
You'll need all of the kernel customizations included in the freedreno chroot method, plus these listed below:
NOTE: You will need some proprietary blobs, which can be found on your device in the /etc/firmware directory.
Config changes to enable booting directly into Ubuntu (beyond replacing the initramfs...):
Code:
CONFIG_EXTRA_FIRMWARE_="audience-es325-fw.bin a300_pm4.fw a300_pfp.fw vidc_1080p.fw"
CONFIG_CMDLINE="console=tty0 fbcon=vc:0-3"
# CONFIG_CMDLINE_FROM_BOOTLOADER is not set
CONFIG_CMDLINE_EXTEND=y
# CONFIG_CMDLINE_FORCE is not set
Optional config changes to enable the framebuffer console when booting directly into Ubuntu - useful for debugging.
Code:
CONFIG_VT_CONSOLE=y
CONFIG_VT_CONSOLE_SLEEP=y
CONFIG_VT_HW_CONSOLE_BINDING=y
CONFIG_DEVPTS_MULTIPLE_INSTANCES=y
CONFIG_FRAMEBUFFER_CONSOLE=m
CONFIG_FRAMEBUFFER_CONSOLE_DETECT_PRIMARY=y
# CONFIG_FRAMEBUFFER_CONSOLE_ROTATION is not set
# CONFIG_FONTS is not set
NOTE: You will need to grab some .ko files that are created, which must be loaded in the following order:
Code:
insmod /ko/font.ko
insmod /ko/softcursor.ko
insmod /ko/bitblit.ko
insmod /ko/fbcon.ko
I recommend that you include these four lines into the init script that is included in the ubuntu ramdisk. These can go pretty much anywhere after the ". /scripts/functions" part, but before it calls out to run-init. Also, don't forget to drop those .ko files into a new /ko directory in the initramfs. If you want to load these with modprobe, I'll leave that up to you (good luck).
Replace the entire ramdisk/initramfs:
At this time, I'm not going to provide instructions on how to do this. You'll need this mako boot.img straight from Ubuntu, repacked with the zImage created here. For what it's worth, the re-pack tool I'm using includes --cmdline 'androidboot.hardware=qcom user_debug=31 zcache', but I'm not sure if that's needed (especially considering our kernel seems to use qcache?). Anyways, good luck.
Step 2 (option B) - Download Custom Kernel Instead
Again, if you don't want to compile your own kernel from source, you can download mine and use it. The same warnings and restrictions apply as they do in Step 0 (option B) of the Freedreno Chroot method. And here's your downloads:
mf3-freedreno-ubuntu-boot-v4.zip - CWM/TWRP flashable zip.
- Boots to Ubuntu directly, but only if your Ubuntu install is located at /data/ubuntu (Default).
- Compiled with the original MF3 initramfs and "mf3-freedreno-everything-zImage-v4" (below).
- Includes all configuration changes described above.
mf3-freedreno-everything-zImage-v4 - Just the MF3 kernel itself with all changes for both chroot and direct booting to Ubuntu.
mf3-freedreno-everything-config-v4 - Yet again, I'm providing my complete .config file for this.
Step 3 - Install the Kernel
Here's the easy part. Flash your completed boot.img, flash loki-doki, and reboot. If you're using my pre-built kernel, first flash mf3-freedreno-ubuntu-boot-v4.zip and then flash loki-doki.zip.
Click to expand...
Click to collapse
Flashable Zip Method (NEWEST):
It's finally finished: a flashable .zip that you can use to dump a pre-built rootfs onto your data partition. This will still require that you flash one of the two custom kernels (whether for chroot or native booting), but it will allow you to skip the whole build/install process.
ubuntu-install-v4.zip - CWM/TWRP flashable .zip. Requires approx 2GB free space on your data partition during install, and the final install size is approximately 1.3GB (may want more free space to add your own programs/etc.). Output folder is /data/ubuntu. This can be changed in u.sh, but heed the warnings within!
Instructions:
Instructions for Chroot-style Ubuntu:
Download the "companions" .zip and extract its contents to the root of /sdcard.
Download the "ubuntu-install" .zip to your internal or external SDCard.
Download the "mf3-freedreno-android-boot" .zip to your internal or external SDCard.
Make a nandroid backup of your phone, and store it on an external SDCard or your computer. Always a good idea to have this.
Install the "ubuntu-install" and "mf3-freedreno-android-boot" .zip files, followed by loki-doki.zip if you need that for your device (e.g. I337).
Restart and resume with Step3 of the Freedreno Chroot Method.
Instructions for Native Boot Ubuntu:
Download the "ubuntu-install" .zip to your internal or external SDCard.
Download the "mf3-freedreno-ubuntu-boot" .zip to your internal or external SDCard.
Install the "ubuntu-install" and "mf3-freedreno-ubuntu-boot" .zip files, followed by loki-doki.zip if you need that for your device (e.g. I337).
Restart and let it start into Ubuntu!
NOTE: The username is "ubuntu" and the password is also "ubuntu" - it is highly recommended that you change this ASAP.
Click to expand...
Click to collapse
Known Issues/Bugs:
Below is the list of known issues that I can think of, from the top of my head. This will probably be updated later as everyone points stuff out. Some issues only apply to some of the methods, so the applicable methods are listed in parenthesis after each.
Sound has not been tested (freedreno/native)
3D graphics or OpenGL support has not been tested (all)
Some applications don't work in a headless environment (vnc)
Some applications don't like to run as root, such as chromium (freedreno) lightdm is working in companions-v3, so no need to login as root anymore
Onboard is not working (freedreno/native) fixed in companions-v3
sudo does not work (all) fixed in kernel-v4 for freedreno/native, but problem remains for (vnc) if you are not using a custom kernel
A few kernel Oops's (native)
Shutdown menu doesn't always work (freedreno/native) fixed partly in companions-v4 - proper locale settings seem to allow the shutdown menu to work once you are logged in
Performance issues due to VNC connection (vnc)
No 3G/WiFi/network connection that I'm aware of... (native)
No control over 3G/WiFi/network/bluetooth yet (all)
Xorg's normal touchscreen driver evdev causes segmentation faults (freedreno/native)
Working on a possibly trying to get fbdev to work natively without Freedreno for simplicity (freedreno/native)
Anything you'd normally expect from a phone does not exist (freedreno/native)
Screen rotation (with or without accelerometer) doesn't work yet (freedreno/native)
HDMI/MHL output remains untested at this time. I got it to briefly work once, but I need to revisit this. (freedreno/native)
Many more to come, I'm sure...
Click to expand...
Click to collapse
To-Do:
Add mirrors to the download links.
Add a CWM/TWRP-flashable .zip that just dumps a clean Ubuntu install onto your data partition. This should be easy enough. completed!
Fix some of the bugs above.
Simplify the launch.sh and xorg.conf files. The u.sh script seems pretty solid.
Develop a method that works with only fbdev. This method might eliminate the possibility of 3D acceleration, but should enable screen rotation and other nifty things.
Possibly look into getting kexec (or similar) to work on the Galaxy S4 to offer a dual-boot option. Low priority at the moment, because flashing a kernel back and forth is pretty easy stuff.
Get Ubuntu Touch to work. This would eliminate a lot of bugs. I mostly need to just buckle-down and build CM10.1 from source, and then slowly visit each step of the Ubuntu Touch boot process.... Ugh.
Rebuild Freedreno to try to get Mesa/Gallium3D working properly. I'm probably going to need a lot of help from Rob Clark on this one!
More to come...
Click to expand...
Click to collapse
Revision History:
[11-13] mf3-freedreno-companions-v2.zip - Updated launch.sh: added some error checking and fixed the Freedreno build process.
[11-15] mf3-freedreno-companions-v3.zip - Updated launch.sh to include onboard and English language. Removed florence and xvkbd. Removed .keyb script. Added sudo. Simplified upstart-dummy, and included new upstart-dummy.tar.gz. Prepped for new flashable .zip method.
[11-26] mf3-freedreno-companions-v4.zip - Updated launch.sh: included fix for onboard so that it should work anytime lightdm is launched, added some bits for sudo to work, and home button now kills lightdm (not just the Xsession); Updated u.sh: Added check for root, added notes about sudo and nosuid.
[11-26] mf3-freedreno-android-boot-v4.zip & mf3-freedreno-ubuntu-boot-v4.zip - Finally fixed sudo! See kernel mods sections for details.
[11-26] ubuntu-install-v4.zip - rebuilt with new companions.
Click to expand...
Click to collapse
Aou said:
Check out this app: SManager (Script Manager). It makes running the ubuntu.sh or u.sh a whole lot easier, plus you can send it into the background (vnc method only). Just remember to jump back into SManager later, use the Menu Key and open the console to be able to kill the ubuntu.sh. You can also add "bash" as an additional argument (freedreno method only). This seems to be an effective replacement for the Terminal Emulator. Don't forget to choose the "su" option to run either script as root.
Click to expand...
Click to collapse
I have literally spent hundreds of hours working on this project, and many more hours documenting it thoroughly - just so that I could share it with all of you. If you found this guide, custom kernel or scripts to be beneficial, please hit the THANKS button on this post.
This mostly works, but I think I may have made an error. I see it starting the sshd, but not VNC server. I can call vncserver, but when launching the vnc client app I just get stuck at "Establishing Handshake" until it times out. This differs from when I don't call vncserver, where I get immediately connection refused.
I'm going to redownload the image and start from scratch, but the image isn't very friendly when I'm trying to figure out how to rerun the initial configuration script...
On my S4 running OTA-MF3 with root, this didn't work for me until i used Busybox Installer from the market. Tried internal and external without it, neither worked. Only thing that looked like an error after that was
Code:
chown: cannot access '/external-sd/': no such file or directory
but this only showed the first time I ran it. Opened VNC connection just fine from my computer to the phone, and though there was slight graphics glitching (orange and red boxes on desktop) it worked just fine and they didn't interfere. Thanks for this!
Tsaukpaetra said:
This mostly works, but I think I may have made an error. I see it starting the sshd, but not VNC server. I can call vncserver, but when launching the vnc client app I just get stuck at "Establishing Handshake" until it times out. This differs from when I don't call vncserver, where I get immediately connection refused.
I'm going to redownload the image and start from scratch, but the image isn't very friendly when I'm trying to figure out how to rerun the initial configuration script...
Click to expand...
Click to collapse
It's not, I agree. I found that the easiest way to clear the configuration and start anew is to do the following from the "[email protected]" prompt (that is, within ubuntu):
Code:
rm /root/DONOTDELETE.txt
rm /root/cfg/linux.config
DeadlySin9 said:
On my S4 running OTA-MF3 with root, this didn't work for me until i used Busybox Installer from the market. Tried internal and external without it, neither worked. Only thing that looked like an error after that was
Code:
chown: cannot access '/external-sd/': no such file or directory
but this only showed the first time I ran it. Opened VNC connection just fine from my computer to the phone, and though there was slight graphics glitching (orange and red boxes on desktop) it worked just fine and they didn't interfere. Thanks for this!
Click to expand...
Click to collapse
Interesting. I looked through the image's init.sh, and found something that's relatively new (wasn't in beta):
Code:
# Fix for sdcard read/write permissions by Barry flanagan
chown ubuntu /external-sd/
As far as I can tell, that message is harmless. It's only included in the initial configuration, as it's in the section:
Code:
if [ ! -f /root/DONOTDELETE.txt ]
As for the need to download/install the BusyBox installer, that's not surprising at all. I've had so much trouble BusyBox ever since I switched to MF3. I might include this as an extra step in the OP - thank you.
You kidding right...does this really work? To cool, thanks Aou. Great work.
TheAxman said:
You kidding right...does this really work? To cool, thanks Aou. Great work.
Click to expand...
Click to collapse
Yessir, it does indeed work! The S4 handles it very nicely with the extra RAM & CPU it has to spare, so the only limiting factor is VNC. If someone could devise a way to get Ubuntu to draw directly on the screen from within that Chroot, that would be perfect. I don't think it's really possible by design, but this might be the closest we get to running native linux on the I337 until we see some unlocked bootloaders.
Thanks
Aou said:
Yessir, it does indeed work! The S4 handles it very nicely with the extra RAM & CPU it has to spare, so the only limiting factor is VNC. If someone could devise a way to get Ubuntu to draw directly on the screen from within that Chroot, that would be perfect. I don't think it's really possible by design, but this might be the closest we get to running native linux on the I337 until we see some unlocked bootloaders.
Thanks
Click to expand...
Click to collapse
In fact I am currently working on getting xorg to write to androids frame buffer which will mean no more vnc
Sent from my Nexus 4 using xda premium
zacthespack said:
In fact I am currently working on getting xorg to write to androids frame buffer which will mean no more vnc
Sent from my Nexus 4 using xda premium
Click to expand...
Click to collapse
You, sir, are the man. thank you so much for working on this! I threw $10 at you to help fund the skittles/cheetos/carrots/beer/pizza/whatever it takes to help you along.
Added a couple things to the OP. Looks like pure-stock roms will indeed need BusyBox installed, by some means or another. Also, found SManager, which makes executing the ubuntu.sh script much, much easier.
The second script that allows me to launch ubuntu, but the first that allows me to get a real X server on my vnc. Thank you so much !
PS: Why am I unable to install wine ?
"Package wine is not available, but is referred to by another package.
This may mean that the package is missing, has been obsoleted, or
is only available from another source"
This is working pretty good, slow though, do I have it setup right, or did I miss something?
TheAxman said:
This is working pretty good, slow though, do I have it setup right, or did I miss something?
Click to expand...
Click to collapse
I have found it to run a bit slow, and with regular crashing of GUI programs too. Is it just slow or unusable? You can always try closing other apps besides terminal and VNC, or try to VNC from a computer even.
tboss1995 said:
The second script that allows me to launch ubuntu, but the first that allows me to get a real X server on my vnc. Thank you so much !
PS: Why am I unable to install wine ?
"Package wine is not available, but is referred to by another package.
This may mean that the package is missing, has been obsoleted, or
is only available from another source"
Click to expand...
Click to collapse
Looks like you're not the only one. Check out this thread on the LinuxOnAndroid site:
http://forum.linuxonandroid.org/index.php?topic=268.0
TheAxman said:
This is working pretty good, slow though, do I have it setup right, or did I miss something?
Click to expand...
Click to collapse
DeadlySin9 said:
I have found it to run a bit slow, and with regular crashing of GUI programs too. Is it just slow or unusable? You can always try closing other apps besides terminal and VNC, or try to VNC from a computer even.
Click to expand...
Click to collapse
Most of the slowness comes from interacting with it via VNC, it would seem. Hard to compare to anything else, considering VNC is all we've got at the moment. I wonder if @zacthespack can shed some light on this. As he mentioned before, he's working on getting it to draw directly to the Android screen. I'm certainly not going to ask for any status updates, but I'm wondering if he can confirm that we'd see a speed increase without VNC...
EDIT: Also, as I use it more, I am noticing the app crashes too (such as Chromium). Could just be something in the 13.04 image, but also could be because we're running this all on ARM architecture.
Aou said:
Looks like you're not the only one. Check out this thread on the LinuxOnAndroid site:
http://forum.linuxonandroid.org/index.php?topic=268.0
Most of the slowness comes from interacting with it via VNC, it would seem. Hard to compare to anything else, considering VNC is all we've got at the moment. I wonder if @zacthespack can shed some light on this. As he mentioned before, he's working on getting it to draw directly to the Android screen. I'm certainly not going to ask for any status updates, but I'm wondering if he can confirm that we'd see a speed increase without VNC...
Click to expand...
Click to collapse
RE installing WINE, sure you can install the ARM verson but Wine is not a emulator (infact WINE stands for Wine Is Not a Emulator) so you can only run ARM compiled windows software.
Yest there is a good speed increase, as with VNC xorg writes to the vnc server and passes it to the vnc client to then render on the screen.
With the new method xorg just writes to Androids frame buffer, no inbetween man.
And it can get even faster once we have graphics accelerations although not all chip sets will get that.
zacthespack said:
RE installing WINE, sure you can install the ARM verson but Wine is not a emulator (infact WINE stands for Wine Is Not a Emulator) so you can only run ARM compiled windows software.
Click to expand...
Click to collapse
Good point, forgot about that. It's really just a big package of Windows dependencies, responding to API calls, etc. The software that Wine runs is still sending stuff to/from the processor directly, therefore it would have to be compiled for ARM.
I wonder what Windows8 programs are available that are compiled for ARM (because of the Microsoft Surface and all...).
Aou said:
Good point, forgot about that. It's really just a big package of Windows dependencies, responding to API calls, etc. The software that Wine runs is still sending stuff to/from the processor directly, therefore it would have to be compiled for ARM.
I wonder what Windows8 programs are available that are compiled for ARM (because of the Microsoft Surface and all...).
Click to expand...
Click to collapse
There's plenty or ARM software within the built in app store, but I'm not sure where they install to or how one would go about extracting them. I have it on desktop and it shows what processors it runs on. Can't wait for the straight to screen function though
Also, I'm going to see if a different image is more stable. Chromium was the most obvious crashing for me and others generally crashed.
DeadlySin9 said:
There's plenty or ARM software within the built in app store, but I'm not sure where they install to or how one would go about extracting them. I have it on desktop and it shows what processors it runs on. Can't wait for the straight to screen function though
Also, I'm going to see if a different image is more stable. Chromium was the most obvious crashing for me and others generally crashed.
Click to expand...
Click to collapse
I noticed that with 12.04, it doesn't seem to connect to Xorg or something, because when you use VNC, it only shows a grey screen with a cross cursor. Same for both "Lite" and "Full" packages. Haven't tried older (10.x) packages of Ubuntu.
The other Linux images should work just fine. Optionally, you can edit the ubuntu.sh script to be more appropriate, but it should theoretically work the same (unless the init.sh is located elsewhere inside the image...).
I tried the Ubuntu 10 image and the Debian image but ubuntu didn't run vnc (vncserver not found or something) and debian kept saying I didn't have permissions.
It appears chromium is incredibly unstable on this image, so I've uninstalled it.
I'm currently working on trying to get Minecraft to work, but ever since 1.6.2 and this new launcher, it's incredibly difficult to modify the client files and such. Something is going wrong with liblwjgl.so. I can get the launcher to work correctly, but when it goes to load the game, it can't find liblwjgl.so and says that it might be because of 32bit vs ARM. I did get lwjgl installed correctly, and pulled the ARM version of the .so and stuck it in [what I believe was] the right .jar file, but it still has the error.
I'll keep you all posted. If I can get this to work, and if zacthespack can get xorg to draw on the android screen, ... :good:
EDIT:
Found out that every time the launcher runs minecraft, it downloads several libraries and other crap to run the game, to keep itself current and to support multiple versions, yada, yada. Unfortunately, this means that it downloads https://s3.amazonaws.com/Minecraft..../2.9.0/lwjgl-platform-2.9.0-natives-linux.jar every time you click Play, and overwrites any custom one you might have (i.e. one with ARM libraries inside). I tried revoking write access to the file, but then the launcher aborts the launch because it can't overwrite the file.
Any suggestions?
EDIT #2:
Well, the easy solution was to modify the file, run the launcher, disconnect mobile data temporarily, and then launch the game ("couldn't connect to server .... have local copy of file .... assuming it's good...."). No more errors about that stupid library file. However, the game immediately crashes now with an error report. Investigating this now. PROGRESS!
Problem
I'm aware I may need to modify the script in order to accommodate my setup, but I figured I'd post here first before changing anything in case someone else had a similar problem and came up with the solution.
I followed all the instructions, except I want to boot from an external USB stick (mounted using StickMount).
I reviewed the script, dropped it on the root of the USB stick, and copied the unzipped image to a folder named ubuntu.
Here is the output when I run the script:
Making mount points and mounting to them...
mount: mounting /dev/loop20 on /data/local/ubmnt failed: Operation not supported
mount: mounting devpts on /data/local/ubmnt/dev/pts failed: No such file or directory
mount: mounting proc on /data/local/ubmnt/proc failed: No such file or directory
mount: mounting sysfs on /data/local/ubmnt/sys failed: No such file or directory
Connecting to /sdcard...
mount: mounting /sdcard on /data/local/ubmnt/sdcard failed: No such file or directory
Putting in some settings...
net.ipv4.ip_forward = 1
/sdcard/usbStorage/sda1/ubuntu.sh[19]: can't create /data/local/ubmnt/etc/resolv.conf: No such file or directory
/sdcard/usbStorage/sda1/ubuntu.sh[20]: can't create /data/local/ubmnt/etc/resolv.conf: No such file or directory
/sdcard/usbStorage/sda1/ubuntu.sh[21]: can't create /data/local/ubmnt/etc/hosts: No such file or directory
ubuntu is configured with SSH and VNC servers that can be accessed from the IP:
(You will see an error about wlan0 if your WiFi is disabled. Safe to ignore.)
----------------- OKAY, starting Ubuntu! -----------------
chroot: can't execute '/root/init.sh': No such file or directory
----------------- Ubuntu has exited! -----------------
Cleaning up - unmounting everything and removing what we made...
umount: can't forcibly umount /data/local/ubmnt/dev/pts: No such file or directory
umount: can't forcibly umount /data/local/ubmnt/sys: No such file or directory
umount: can't forcibly umount /data/local/ubmnt/proc: No such file or directory
umount: can't forcibly umount /data/local/ubmnt/sdcard: No such file or directory
umount: can't forcibly umount /data/local/ubmnt: Invalid argument
Welcome back to your android.
Click to expand...
Click to collapse
I am running as root, BusyBox free has been installed. My terminal app has been granted root privileges. The path to the USB stick is sdcard/usbStorage/sda1.
Any help/guidance would be greatly appreciated! :fingers-crossed:
adbkp-gui
It is for linux, can be made for windows too, as it is open source :angel:
Ever wondered, controlling your phone with your PC? Even possible? Yes!
but, "adb input x y" everytime???
Click to expand...
Click to collapse
No.
but, adb input x y doesn't work on ICS!
Click to expand...
Click to collapse
Yes, I know. That's when I got @Twin0ne's guide, TUTORIAL: Remote Control Touch Screen, but it was half-done So, I figured out the other half of the guide myself (which was easy to do, given the first half is pretty-self explanatory), and was able to get touch events on the phone, and soon, keypress events.
So, made a GUI with Qt, to make things easier
Changelog:
v2.2.5:
Reimplemented recalibrate() function to run automatically at startup
Easier to port, as platform-specific code is lessened
Needs single standalone executable, with adb in environment path
v2.0:
Diagonal touch added
re-worked touch functions
added re-calibrate function for multiple ROM support
v1.0:
Initial Release
Credits:
Twin0ne's guide (TUTORIAL: Remote Control Touch Screen)
https://www.kernel.org/doc/Documentation/input/multi-touch-protocol.txt
App preview:
How to use:
You need Qt 5.
Installation instructions for Qt:
Code:
sudo add-apt-repository ppa:ubuntu-sdk-team/ppa
sudo apt-get update
sudo apt-get install qt-sdk
Then, install adb using "sudo apt-get install android-tools-adb" or similar
*or*
Reference adb path in your ~/.bashrc file!
Then, chmod ./adbkp-gui (if necessary) and execute normally.
Source: https://github.com/vineethraj49/adbkp-gui
XDA:DevDB Information
adbkp-gui, a Tool/Utility for the HTC Pico (Explorer)
Contributors
thewisenerd
Version Information
Status: Stable
Current Stable Version: v2.2.5
Stable Release Date: 2013-10-22
Created 2013-11-16
Last Updated 2013-11-16
Downloads
Downloads:
v2.2.5: https://github.com/vineethraj49/adbkp-gui/releases/download/v2.2.5/adbkp-gui
v2.0: View attachment adbkp-gui_v2.0.zip
Where's version 1.0?
Well, though sources were on GitHub, it was never intended to be released. v2.0, I thought it was good enough for public release
TODO:
Directly obtain event codes from phone (with help from: http://ktnr74.blogspot.in/2013/06/emulating-touchscreen-interaction-with.html)
You suggest!
There's BBQScreen! A much better alternative! More info: http://screen.bbqdroid.org/
reserved...
Reserved... just in case
@vineethraj49
how to run in ubuntu 12 cant understand how to do it
tried serching but got some error then
sakshamx said:
@vineethraj49
how to run in ubuntu 12 cant understand how to do it
tried serching but got some error then
Click to expand...
Click to collapse
You'd need to install the Qt5 and Qt4 from this PPA: https://launchpad.net/~ubuntu-sdk-team/+archive/ppa
Then, you'd be able to run it!
If you are looking for a faster method of controlling your phone, (and don't mind shelling out a few bucks), here's something useful: http://screen.bbqdroid.org/
Click to expand...
Click to collapse
vineethraj49 said:
You'd need to install the Qt5 and Qt4 from this PPA: https://launchpad.net/~ubuntu-sdk-team/+archive/ppa
Then, you'd be able to run it!
Click to expand...
Click to collapse
the app is running now some part in sdk was missing:silly:
but its not showing the screen and cant use any buttons on it
sakshamx said:
the app is running now some part in sdk was missing:silly:
but its not showing the screen and cant use any buttons on it
Click to expand...
Click to collapse
You need to connect your phone, and press the "re-calibrate" button
vineethraj49 said:
You need to connect your phone, and press the "re-calibrate" button
Click to expand...
Click to collapse
re caliberate not working just showing a blank screen
what extra data to be download for adb to work ?
sdk is required to download externally (full package) and add code in bashrc for adb to work?
i have already donloaded the stuff from the that code
sakshamx said:
re caliberate not working just showing a blank screen
what extra data to be download for adb to work ?
sdk is required to download externally (full package) and add code in bashrc for adb to work?
i have already donloaded the stuff from the that code
Click to expand...
Click to collapse
hmm...
you need to connect your phone, and your phone should be recognized with "adb devices"...then, open gui, and press recalibrate first... and you need to be able to see qt in your menu...
p.s. made a silly mistake of not including logging... will try to add logging support to the app as soon as possible
seems the 32-bit adb in the bin folder was causing the problem... next release with logging, and you'd have to install adb yourself using "apt-get install android-tools-adb", or set it in your path... no etas
p.s. recalibration done at app-execution time