diff --git a/dynebolic/bootingonusb/index.html b/dynebolic/bootingonusb/index.html index a006d6c..2cec217 100644 --- a/dynebolic/bootingonusb/index.html +++ b/dynebolic/bootingonusb/index.html @@ -289,6 +289,48 @@ + + +
  • + + + Booting in a Virtual Machine + + + + +
  • @@ -456,6 +498,48 @@ + + +
  • + + + Booting in a Virtual Machine + + + + +
  • @@ -480,7 +564,7 @@

    On windows

    On Windows you can use an application called Rufus to flash the ISO file to a USB drive. The interface is very intuitive, plug the usb stick, select the volume to install on and the ISO image you just downloaded to install. After pressing start it will recognize the image and will ask you to either install normally or in dd mode, please select dd mode.

    On GNU+Linux

    -

    On GNU+Linux, find the device of your USB stick, read your system messages via dmesg command: dmesg | grep " sd "

    +

    On GNU+Linux, find the device name of your USB stick, with this command: lsblk -o NAME,SIZE,RO,TYPE,VENDOR,HOTPLUG

    The name you are looking for should be something like /dev/sdX (where "X" is a letter defined by your system). Read the information carefully, because it will include de sdX name of the main drive of your computer. Once you've determined the name of your USB stick, run this command as root:

    dd bs=4M if=dynebolicIV.iso of=/dev/sdX status=progress && sync

    @@ -489,6 +573,54 @@

    On GNU+Linux

    Once this command has completed, the USB stick will be ready to boot.

    Be sure to know the hotkey to press at boot for boot selection, or bios interface to configure USB boot.

    +
    +

    Booting in a Virtual Machine

    +

    A virutal machine allows you to run an Operative System within your running Operative system. This way you can leverage all that dynebolic has to offer without the need to install it on your machine.

    +

    Virtual Machine Manager

    +

    On of the most user-friendly ways to run dynebolic in a virutal machine is using Virtual Machine Manager. This tool will provide you with a GUI and take care of many complicated parts such as the routing to your physical audio and network tools more or less seemlessly. It also sets everything up to have copy+paste working from your physical machine's desktop to dynebolic.

    +

    To install Virtual Machine Manager, follow the instructions on their website

    +

    Once installed you can run it an add a virtual machine. To do this follow these intstructions

    +

    Hit the "+" button in the upper left corner of the GUI. You will be presented with a prompt asking you to choose how you would like to install the operative system.

    +
    + Chose "Local install media" +
    Chose "Local install media"
    +
    +

    In the next panel, you are asked to pick the file you want to use.

    +
    + Pick the isofile +
    Chose ISO
    +
    +

    This will open prompt that allows you brose your file system. Click "Browse Local" and locate the ISO file you downloaded from dynebolic.org

    +
    + Pick the isofile +
    Pick the ISO file you downloaded
    +
    +

    You will come back to the previous window, chose an operative system. Since Devuan is based on Debian chose, "Debian 12 and click "Forward".

    +

    In the next prompt, you are invited to allocate resources to the virtual machines in terms of CPU cores and RAM. You can safely allocate half of your resouces for both. In this example the machine has 4 cores and 4GB (4096 bytes) ram. So we allocate 2 cores and 2Gb (2048 bytes) RAM.

    +
    + Alocate resources +
    Alocate resources
    +
    +

    In the next prompt, you can allocate disk space to your virtual machine. This is a file that will be mounted as if it was a drive. It will contain all the data you create, so you might want to choose a good location for it. The extention for the file is .qcow2. In the screenshot bellow, we gave it 10Gb and stored the file in ~/Documents/dynebolic.qcow2

    +
    + Alocate diskspace +
    Alocate diskspace
    +
    +

    We then get a chance to review the settings and name the Virtual Machine. Let's name it "dynebolic" and click "Finish".

    +
    + Name the Virtual Machine +
    Name the Virtual Machine
    +
    +

    This will initiate the virtual machine and you should now see a virtual screen with a boot slection. Pick the first entry by hiting the Enter key on your keyboard.

    +
    + Run the Virtual Machine +
    Run the Virtual Machine
    +
    +

    VoilĂ ! Give a few moments, and dynebolic will boot inside your computer.

    +
    +

    QEMU (TODO)

    +

    QEMU is a generic and open source machine emulator and virtualizer.

    +

    On windows (todo)

    diff --git a/dynebolic/images/browse.webp b/dynebolic/images/browse.webp new file mode 100644 index 0000000..25bf652 Binary files /dev/null and b/dynebolic/images/browse.webp differ diff --git a/dynebolic/images/choose.webp b/dynebolic/images/choose.webp new file mode 100644 index 0000000..e736c7f Binary files /dev/null and b/dynebolic/images/choose.webp differ diff --git a/dynebolic/images/diskspace.webp b/dynebolic/images/diskspace.webp new file mode 100644 index 0000000..c172be8 Binary files /dev/null and b/dynebolic/images/diskspace.webp differ diff --git a/dynebolic/images/name-vm.webp b/dynebolic/images/name-vm.webp new file mode 100644 index 0000000..9e09c8b Binary files /dev/null and b/dynebolic/images/name-vm.webp differ diff --git a/dynebolic/images/pick.webp b/dynebolic/images/pick.webp new file mode 100644 index 0000000..1005119 Binary files /dev/null and b/dynebolic/images/pick.webp differ diff --git a/dynebolic/images/resources.webp b/dynebolic/images/resources.webp new file mode 100644 index 0000000..2f3f548 Binary files /dev/null and b/dynebolic/images/resources.webp differ diff --git a/dynebolic/images/vm-running.webp b/dynebolic/images/vm-running.webp new file mode 100644 index 0000000..7036679 Binary files /dev/null and b/dynebolic/images/vm-running.webp differ diff --git a/dynebolic/search/search_index.json b/dynebolic/search/search_index.json index 2b666a0..b347e85 100644 --- a/dynebolic/search/search_index.json +++ b/dynebolic/search/search_index.json @@ -1 +1 @@ -{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Dynebolic IV GNU/Linux User's Guide","text":"

    2024 Denis Jaromil Rojo & The dynebolic Documentation Team

    "},{"location":"#what-is-dynebolic","title":"What Is dynebolic?","text":"

    Dynebolic is a 100% Free Software Operating System for multimedia production, recommended by the Free Software Foundation. It is a live ISO that can run from a CD or Drive, without the need to install.

    "},{"location":"#be-welcome-to-a-gnulinux-world","title":"Be Welcome to a GNU+Linux World!","text":"

    For culture and information to circulate freely and unbiased, media activists, artists and creatives need to be independent from corporate alienation. Dynebolic is an Operating System and a practical tool for multimedia production: it enables the manipulation and broadcasting of both audio and video with tools to record, edit, encode, stream, and publish. Dyne:bolic automatically recognizes most device and peripherals: audio, video, TV, network cards, firewire, usb and more; all using only free software!

    "},{"location":"#100-free-as-in-speech","title":"100% Free, As In Speech","text":"

    Dynebolic is a GNU+Linux distribution recommended by the Free Software Foundation: no proprietary software is inside, no closed source firmware, no hockus pockus. Everything is transparent and can be peer reviewed. All of this without ever compromising with the expression creatives rely on.

    You are free to study, modify, redistribute and even sell this Operating System, as long you grant the same freedom to your peers.

    "},{"location":"#friendly-to-the-environment","title":"Friendly To The Environment","text":"

    Dynebolic is designed to run on computers with extremly low ressources (dynebolic III was benchmarked at Pentium2 processors with 256MB RAM). It can even run in ram: not even a harddisk is required.

    Unleash the full potential of computers, including second hand machines. Let\u2019s put an end to consumerism and use what already exists to its full potential.

    "},{"location":"#digital-resistance","title":"Digital Resistance","text":"

    The dynebolic Operating System is about resilience and digital resistance. In a reality where governments and corporation are exercising control by monitoring the way people communicate, hackers, creatives and citizens of the digital era have a common interest in keeping their computing sovereign. To accomplish this, sharing knowledge is paramount.

    Liberate yourself from mental slavery. Embrace sovereign communication. Free your mind, open the source!

    "},{"location":"#freedom-needs-privacy","title":"Freedom Needs Privacy","text":"

    Dynebolic Operating System does not include any cloud-service and does not establish background communications without the consent of the user.

    Dynebolic also includes support for strong encryption of private data, thanks to Dyne.org's Tomb.

    "},{"location":"#freedom-of-expression","title":"Freedom of Expression","text":"

    More than the means of media playback, dynebolic includes free software for the production of professional grade multimedia.

    For everything you can see and play, dynebolic includes the software to create it. This Operating System lets you express yourself, without the need to rent a license or install additional components. dynebolic was built to make it possible for people to be the independent producers of their own story. Not just content creators for corporate platforms or consumers of information.

    "},{"location":"#appreciated-worldwide","title":"Appreciated Worldwide","text":"

    Since its birth in 2000, dynebolic has been redistributed by several magazines and adopted by universities, community initiatives, medialabs and public institutions around the World.

    "},{"location":"#how-is-dynebolic-different-from-other-live-distros","title":"How is dynebolic different from other live distros?","text":"

    True to the original desire to put digital power in the hands of the people, we craft dynebolic to fill the gap between expression and technology. Our legacy stretches over decades.

    Free Software is the idea that, operating-, using-, modifying- and sharing- means of digital production, is the only way for humans to create and communicate safely in the digital realm. With dynebolic we apply this idea, to a carefully curated list of applications and utilities, in ways that align perfectly with the principles of Free Software. More than a distribution, dynebolic is a human centric community, facilitating professional grade multimedia tools to the masses.

    dynebolic is a nomadic system, meaning it is ready to move in to your device with a minimum of material friction. But it shall also follow you on the road, where the conditions may be unpredicatble. For many dynes, it is a gateway to the freedom to compute and a reaching hand for travelers looking to onboard the liberty of expression.

    "},{"location":"appendix/","title":"Appendix II: The Dyne Foundation","text":"

    Dynebolic is brought to you by the Dyne Foundation. The Dyne Foundation is a think & do tank, born as an on-line community in 1999 by uniting artists, activists and hackers of mixed backgrounds. It is also a young research organization working on a growing number of succesful projects for the European Commission. These are its three guiding principles:

    The Dyne Foundation develops and promotes projects focused on free software and free culture, and hosts the development of a large selection of free software. Notably, the Dyne Foundation hosts and supports the development of the Devuan \"init freedom\" Linux Distribution, which dynebolic is based on.

    "},{"location":"appendix/#appendix-iii-links-and-other-sources-of-information","title":"Appendix III: Links and other sources of information","text":""},{"location":"appendix/#further-info","title":"Further info","text":""},{"location":"appendix/#other-documentation-sources","title":"Other Documentation sources","text":""},{"location":"appendix/#online-communities","title":"Online Communities","text":""},{"location":"appendix/#license","title":"License","text":"

    GFDL, I believe.

    "},{"location":"bootingonusb/","title":"Booting dynebolic","text":"

    There are many ways to boot dynebolic on your computer. First, you need to download the ISO file and verify the checksum.

    "},{"location":"bootingonusb/#booting-from-usb","title":"Booting from usb","text":""},{"location":"bootingonusb/#on-windows","title":"On windows","text":"

    On Windows you can use an application called Rufus to flash the ISO file to a USB drive. The interface is very intuitive, plug the usb stick, select the volume to install on and the ISO image you just downloaded to install. After pressing start it will recognize the image and will ask you to either install normally or in dd mode, please select dd mode.

    "},{"location":"bootingonusb/#on-gnulinux","title":"On GNU+Linux","text":"

    On GNU+Linux, find the device of your USB stick, read your system messages via dmesg command: dmesg | grep \" sd \"

    The name you are looking for should be something like /dev/sdX (where \"X\" is a letter defined by your system). Read the information carefully, because it will include de sdX name of the main drive of your computer. Once you've determined the name of your USB stick, run this command as root:

    dd bs=4M if=dynebolicIV.iso of=/dev/sdX status=progress && sync

    Note

    You have to adapt this line so that \"X\" represents its actual value in your system.

    Once this command has completed, the USB stick will be ready to boot.

    Be sure to know the hotkey to press at boot for boot selection, or bios interface to configure USB boot.

    "},{"location":"developers/","title":"For Developers","text":"

    Greetings, fellow devel! \ud83d\udd96\ud83c\udffd

    dynebolic welcomes contributions, big and small. You are here by invited to clone the repository localy and get yourself an account on the Devuan Gitea. For your convenience the repository is mirrored on GitHub. However, due to the ownership model of GitHub we encourage you to stick to the Devuan Gitea. From the Gitea interface you will be able to fork the repository and send Pull Requests. But you are welcome to ask for write permission in the bridged chat.

    "},{"location":"developers/#source-code","title":"Source code","text":"

    https://git.devuan.org/jaromil/dynebolic

    "},{"location":"developers/#come-talk-to-us","title":"Come talk to us","text":"

    These channels are all bridge, meaning it doesn't matter whether you are using one or the other, you will be able to communicate with everyone.

    "},{"location":"developers/#the-dynebolic-sdk","title":"The dynebolic SDK","text":""},{"location":"developers/#dynebolic-modules","title":"Dynebolic Modules","text":""},{"location":"developers/#system-development","title":"System Development","text":""},{"location":"developers/#developing-for-the-desktop","title":"Developing For The Desktop","text":"

    The dynebolic SDK offers various workflows. To get the full list of targets, cd into your cloned repository and run make. This will present you with a list of Make targets that will help you contribute to the project.

    "},{"location":"developers/#getting-dynebolic-development-up-and-running","title":"Getting dynebolic development up and running","text":"

    The two workflows Desktop devleopers are interested in are \"Quick start\":

     ----             __ Quick start:\n deps             \ud83d\udee0 Install development dependencies\n setup            \ud83d\udce5 Download the latest development ROOT modules\n system           \ud83d\uddff Build the root system: dyneIV-root\n iso              \ud83c\udfc1 Create the current ISO image\n qemu             \ud83d\udda5 Emulate UEFI USB boot using qemu\n burn             \ud83d\udd25 Write the ISO to a removable USB=/dev/sd?\n

    and \"Snapshot testing\"

     -----            __ Snapshot testing functions:\n snap-iso         \ud83e\udde8 Test a squashed snapshot as ISO FILE=path\n snap-mount       \ud83d\udc40 Explore the contents of a snapshot FILE=path\n snap-umount      \ud83d\udd0c Stop exploring and unplug the snapshot\n test-changes     \ud83c\udf73 Test current changes in home and static\n
    Most of these make commands need to be run as root. This can be achieved in different ways depending on your operating system.

    To bootstrap your Desktop development environement, follow this sequence:

    1. make deps (requires root)
    2. make setup (requires root)
    3. make system (requires root)
    4. make iso (requires root)

    Each command will take a moment to complete and be quite verbose. Don't fear it. It might look scary, but your computer is talking to you, so listen!

    Once you have ran all of the four commands, there will be a new file in your local repository called dynebolic.iso. This is an image of the dynebolic install disk.

    You can now test it by running:

    1. make qemu

    This will start a virtual environement in which dynebolic will boot. If everything was made correctly, you will see the grub menu. Pick the first entry.

    grub menu

    Soon see the desktop appear. Once it does, you can proceed and make changes to the desktop and then export them. Even though it is slightly more time consuming, it is advisable to make one change and export at the time.

    "},{"location":"developers/#export-changes","title":"Export changes","text":"

    Once you have made the desired changes, from within the virutal d:b dekstop, start a terminal and become root. To do this type: su. The system will ask you for a password. The password is dyne. It will look like this:

    dyne@dynebolic ~ \u276f su\nPassword:\nroot@dynebolic:/home/dyne#\n

    The user changed to root, and you may now export your changes. To do this, type:

    dyne-snapshot

    Accept the identity of the remote server, by typing yes and hitting enter.

    This will fetch any modified file, package them into a single file and upload them to the snapshot server. You will be presented with a URL. Using this method, you won't be able to copy it from your virtual machine to your machine. To fetch this snapshot, either use the QR code with your phone to transfer it to yourself. Or head over to the snapshot server and sort the files by \"Last Modified\".

    "},{"location":"developers/#inspecting-changes-to-commit-them","title":"Inspecting changes to commit them.","text":"

    Terminate the virutal machine for now. To inspect your snapshot, download your snapshot to the root of your cloned repository and mount it.

    This will create a folder in the root of your cloned repository called \"snap-mount\" containing all the modified files. Navigate into it and run ncdu.

    cd snap-mount\nncdu\n

    This will show you a browser like view where you can browse through the modified files. To close it, hit the \"Q\" key on your keyboard

    Still as root, copy the files you are interested in to a different folder:

    In the root of your cloned repository, there is a folder called static. This is where the configuration files for the desktop and system are residing. Copy over the files to this folder following the same structure. If your file is snap-export/home/dyne/.config/my-amazing-settings.conf, move it to static/home/dyne/.config/my-amazing-settings.conf

    Once you have done this, you need to make sure that your changes are going to give the desired effect. This because, maybe you forgot something? Maybe there are more files responsible for the changes you want?

    This will launch a virtual machine taking into account your changes. When the desktop appears, you should be able to see your changes. If you do, commit them to the repository:

    "},{"location":"developers/#appendices","title":"Appendices","text":""},{"location":"developers/#appendix-i-a-brief-history-of-dynebolic","title":"Appendix I: A Brief History of dynebolic","text":"

    The first edition of dynebolic was released

    "},{"location":"disclaimer/","title":"Disclaimer","text":""},{"location":"disclaimer/#disclaimer","title":"Disclaimer","text":"

    Dynebolic GNU/Linux is copyright (C) 2001 - 2024 Denis Jaromil Roio

    Dynebolic is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

    "},{"location":"getting_started/","title":"Getting Started with dynebolic","text":""},{"location":"getting_started/#your-desktop-environment","title":"Your Desktop Environment","text":"

    Dynebolic doesn\u2019t require you to install anything on your harddisks, which can be left untouched while the system is used. Still, depending from your preferred way to operate, it can boot from harddisk, CD, USB or network (explained the following chapter) and it can store data in a single file that can be transported across different media.

    The default desktop environment is KDE Plasma 6, which offers you multiple desktops (try ctrl+F2 and other numbers) and a menu that you can recall by clicking the right mouse button on the background. On the upper right corner you have your storage devices which you can access with a click.

    Inside the application menu software is organized by tasks, so you can easily find your way to play, record, edit and stream both audio and video, communicate and publish text, webpages, 3d animations and much more.

    KDE Plasma offers Activities, which are a practical way to organize your workflows depending on the task at hand, whether you're editing video, recording and mixing audio, processing digital photographs, or running a live media stream. When you start your dynebolic desktop session, you will find a number of pre-configured Activities: Audio, Video, Streaming, etc. You can think of these Activities as workplaces dedicated to a particular line of work. They are, of course, not exclusive: nothing stops you from pulling out Inkscape to work on an album cover for a track you're currently mastering in the Audio Activity.

    In the following chapters, we will look at what is available to you in each Activity.

    "},{"location":"getting_started/#working-with-video","title":"Working with Video","text":""},{"location":"getting_started/#introduction","title":"Introduction","text":"

    The GNU/Linux platform nowadays offers an interesting range of tools for video production, editing and manipulation; you can play all kind of video files, but also encode them for distribution and switch between formats. Furthermore, you\u2019ll find software for recording, veejaying and streaming, non-linear editing and subtitling.

    However, you should consider that most of the video tools running on GNU/Linux platform are in development: indeed you can help much in testing and reporting the bugs you encounter, that\u2019s how anyone can help free software to grow better and better, as it does.

    Now let's proceed on how to configure an available video device and then browse thru the video software included in dynebolic, following a subdivision in task categories.

    "},{"location":"getting_started/#configure-your-video-devices","title":"Configure your video devices","text":"

    There are various devices that can be used on PC computers in order to have video input: USB webcams and capture cards, PCI TV cards, Firewire and even parallel port. They all have different chipsets and manufacturers and need different Linux device drivers.

    Dynebolic is capable of automatically recognizing most PCI (internal) TV cards at boot time (WinTV, BTTV) and now also USB webcams as well as Firewire controllers: they will all be initialized at boot and can be accessed from the video device /dev/video0 or subsequent numbers (video1, video2 \u2026.) in case you have more than one. [FIXME: double-check that]

    If your video device is not recognized automatically (the /dev/video doesn\u2019t exist) then you need to configure it by hand.

    If the online documentation says your device is supported by a particular kernel driver, you can try to load it using the command modprobe modulename and see if everything went well by looking in the last lines of the messages printed out by the dmesg command. Many modules are already present in dynebolic, but some might require to be compiled using the kernel sources, which is a more complicated process that can\u2019t be explained here: you\u2019ll need to find more instructions online about how to do it and download the Linux kernel sources. If you\u2019ll even do it, keep in mind that once you have compiled your own kernel you have moved your very first step into becoming a hacker ;).

    "},{"location":"getting_started/#video-tools-and-programs","title":"Video tools and programs","text":""},{"location":"getting_started/#kdenlive","title":"KDEnlive","text":"

    KDEnlive (the KDE Non-Linear Video Editor) is one of the best free and open-source video editing programs. It is based on the MLT Framework, which allows it to integrate many plugin effects for video and sound processing or creation. Furthermore KDEnlive brings a powerful titling tool, a DVD authoring solution, and can be used as a complete studio for video creation.

    "},{"location":"getting_started/#frei0r","title":"Frei0r","text":"

    Frei0r is a free and open source plugin collection for video effects. Applications can use its API to embed more than 100 video filters, sources and mixers.

    Frei0r is a minimalistic plugin API for video effects. The main emphasis is on simplicity for an API that will round up the most common video effects into simple filters, sources and mixers that can be controlled by parameters. It\u2019s our hope that this way these simple effects can be shared between many applications, avoiding their reimplementation by different projects.

    Frei0r is not meant as a competing standard to more ambitious efforts that try to satisfy the needs of many different applications and more complex effects. It is not meant as a generic API for all kinds of video applications, as it doesn\u2019t provides things like an extensive parameter mechanism or event handling. Eventually the frei0r API can be wrapped by higher level APIs expanding its functionalities (for instance as GStreamer, MLT, FFmpeg and others do).

    Frei0r has been developed with production video software in mind, not video players or desktop toys of sorts. For instance it can be used like GStreamer, but its different as it aims to be lighter, for instance allowing host application developers to avoid memcpy and other buffering operations. Also it doesn\u2019t enforces dependency from GNOME and such desktop frameworks.

    "},{"location":"getting_started/#etc","title":"Etc.","text":""},{"location":"getting_started/#working-with-audio","title":"Working with Audio","text":"

    This distribution is full with audio software to do all kind of things: electronic music, sound processing, voice effects, interviews and more. And there is one important thing that makes this system superior to any other commercial solution: there is no competition :)

    Most of the audio applications in dynebolic can be connected together, input to output, in order to form a chain of tools processing the sound: this is done thanks to a technologies like Pipewire, JACK and the Advanced Linux Sound Architecture (ALSA). Instead of keeping separated the tasks of every single application, now it is possible to take advantage of the great variety of approaches that a GNU/Linux system like dynebolic has to offer.

    "},{"location":"getting_started/#audio-tools-and-programs","title":"Audio tools and programs","text":""},{"location":"getting_started/#audacity","title":"Audacity","text":"

    Audacity is a user-friendly audio editing program suitable to manipulate your audio files, interviews and recordings, separating or mixing them, applying effects and encoding in various formats. It can also be used to record audio straight away via its intuitive interface, which can be commonly found also on other operating systems since it is a cross-platform free application. A perfect choice to start manipulating audio.

    "},{"location":"getting_started/#ardour","title":"Ardour","text":"

    Ardour is the fully featured multitrack studio that offers the most advanced interface for your music recording studio. Combined together with other applications when necessary (it also uses Jack) it can really solve all your needs for audio mastering and music production. Check the online documentation for this valuable software on the Ardour homepage: if you are a musician, the patience needed to learn it\u2019s usage and hotkeys is definitely worth the effort.

    "},{"location":"getting_started/#mixxx","title":"Mixxx","text":"

    Mixxx is currenly the most popular libre DJ Automation and digital DJ performance application. It includes many features common to digital DJ solutions as well as some unique ones: it natively supports advanced MIDI and HID DJ controllers, is licensed under the GPL-2.0-or-later and runs on all major desktop operating systems. The project was started in early 2001 for a doctoral thesis as one of the first digital DJing systems

    "},{"location":"getting_started/#some-technicalities","title":"Some technicalities","text":""},{"location":"getting_started/#audio-servers","title":"Audio servers","text":"

    The zoo of Linux audio servers.

    (Obligatory XKCD 927 here.)

    1. The ALSA audio back-end.

    2. The JACK audio server

      Still going strong.

    3. Pulseaudio

      Explain why Pulseaudio is a Crime against Nature, and why \"Poettering\" is a gerund.

      (I honestly hope we won't have to deal with PA here.)

    4. The Pipewire audio server

      One media server to rule them all.

    "},{"location":"getting_started/#pipewire-session-management","title":"Pipewire Session Management","text":""},{"location":"getting_started/#streaming-media","title":"Streaming Media","text":"

    Now that you have worked hard on your media, be it a podcast, experimental video, music, or sound art, you might feel the need to get it out there in the world. As far as streaming media goes, dynebolic's Streaming Activity has you covered.

    "},{"location":"getting_started/#obs-studio","title":"OBS Studio","text":"

    OBS Studio (the Open Broadcaster's Software Studio) is a free and open-source, cross-platform app for screencasting screencasting and live streaming. It is available for Linux and BSD distributions, as well as other operating systems. OBS Studio provides real-time capture, scene composition, recording, encoding, and broadcasting via Real-Time Messaging Protocol (RTMP), HLS, SRT, RIST or WebRTC. It can stream videos to any RTMP-supporting destination, including YouTube, Twitch, Instagram and Facebook

    In recent years (and especially in the wake of the COVID-19 crisis), OBS Studio has become the most popular tool for countless podcasts, live streaming sessions, news broadcasts, or live coding. It can use any number of cameras and sound sources, and can be comfortably configured to stream any computer screen or program window we choose.

    "},{"location":"getting_started/#butt","title":"BUTT","text":"

    If our streaming project doesn't need all the power and features of OBS Studio, or we need to join a broadcast using an Icecast server, the ideal tool for the job is BUTT.

    Broadcast Using This Tool (charmingly contracted to BUTT) is an easy to use, multi-OS streaming tool. It supports SHOUTcast and Icecast and runs on Linux and other operating systems. The main purpose of BUTT is to stream live audio data from your computers mic or line input to a Shoutcast or Icecast server. It also has facilities for recording our session.

    One peculiarity of BUTT is that it is focused on live audio - that is, it will broadcast a microphone, instrument, or software synth source to the Icecast server's mount point, but it will not stream recorded media files. (But nothing stops you from using it to stream your DJ session with Mixxx, for example.)

    "},{"location":"getting_started/#working-with-graphic-design","title":"Working With Graphic Design","text":""},{"location":"getting_started/#inkscape","title":"Inkscape","text":"

    Inkscape is a free and open source vector graphics editor for GNU/Linux and other operating systems. It offers a rich set of features and is widely used for both artistic and technical illustrations such as cartoons, clip art, logos, typography, diagramming and flowcharting. It uses vector graphics to allow for sharp printouts and renderings at unlimited resolution and is not bound to a fixed number of pixels like raster graphics. Inkscape uses the standardized SVG file format as its main format, which is supported by many other applications including web browsers. It is an ideal tool for flyers, high-resolution prints and pre-flight DTP work.

    "},{"location":"getting_started/#krita","title":"Krita","text":"

    Krita is a free and open source cross-platform application that offers an end-to-end solution for creating digital art files from scratch. It is made by artists that want to see affordable art tools for everyone. Krita is optimized for frequent, prolonged and focused use. Explicitly supported fields of painting are illustrations, concept art, matte painting, textures, comics and animations. Krita supports open standards and interoperates with other applications.

    Krita\u2019s tools are developed keeping the above vision in mind. Although it has features that overlap with other raster editors its intended purpose is to provide robust tool for digital painting and creating artworks from scratch.

    "},{"location":"getting_started/#blender","title":"Blender","text":"

    Blender is the free and open source 3D creation suite. It supports the entirety of the 3D pipeline\u2014modeling, rigging, animation, simulation, rendering, compositing and motion tracking, even video editing and game creation. Advanced users employ Blender\u2019s API for Python scripting to customize the application and write specialized tools; often these are included in Blender\u2019s future releases. Blender is well suited to individuals and small studios who benefit from its unified pipeline and responsive development process. Examples from many Blender-based projects are available in the showcase.

    Blender is cross-platform and runs equally well on Linux and other operating systems. Its interface uses OpenGL to provide a consistent experience. To confirm specific compatibility, the list of supported platforms indicates those regularly tested by the development team.

    Indeed, Blender is such a powerful and complex multimedia tool, that it fits equally well in the Video and here in the Graphic Design Activities of dynebolic.

    "},{"location":"getting_started/#working-with-photography","title":"Working With Photography","text":"

    Whether you just need to crop or apply an effect on a bitmap image, or you need to establish a good RAW development workflow, the Photography Activity has the tools for you.

    "},{"location":"getting_started/#gwenview","title":"Gwenview","text":"

    Gwenview, the KDE Plasma default image viewer, is a fast and lean tool for viewing images and browsing and annotating picture collections. It even offers some basic editing operations, such as image resizing and cropping, which make it very handy for moments when a heavier tool would be overkill.

    "},{"location":"getting_started/#the-gnu-image-manipulation-program","title":"The GNU Image Manipulation Program","text":"

    The GNU Image Manipulation Program is a well mature application capable to create and edit bitmap images, offers a perfect environment for web graphics as well a powerful script engine to automatize its operations and even generate automatically stylish logos.

    "},{"location":"getting_started/#darktable","title":"Darktable","text":"

    Darktable is an open source photography workflow application and RAW developer. A virtual lighttable and darkroom for photographers. It manages your digital negatives in a database, lets you view them through a zoomable lighttable and enables you to develop RAW images and enhance them.

    "},{"location":"getting_started/#digikam","title":"digiKam","text":"

    digiKam is an advanced open-source digital photo management application that runs on Linux and other operating systems. The application provides a comprehensive set of tools for importing, managing, editing, and sharing photos and raw files. While digiKam also has RAW development capabilities, its strong point is in library management and cataloging. It also has a useful set of plugins which enable direct publishing to online sites such as Flickr and others.

    "},{"location":"getting_started/#the-lensfun-database","title":"The lensfun database","text":"

    Dynebolic comes with enough powerful tools for digital photography to satisfy a photographer's needs. Nevertheless, an important step in setting up our digital photography workflow is updating the lensfun database. lensfun is an open, collaborative database of camera and lens profile, which are essential for RAW development operations, such as lens correction. If Darktable can't find the profile of your camera model or lens (or at least the closest possible one), chances are your lensfun database hasn't been updated.

    To do this, we open Konsole, and do the following:

    > lensfun-update-data\n

    And that's it. You won't need to do anything else - Darktable or other RAW processing tools will use the updated lensfun database in the background.

    "},{"location":"getting_started/#learn-more","title":"Learn more","text":""},{"location":"getting_started/#publishing","title":"Publishing","text":"

    Although nowadays most of what we call \"publishing\" happens online, we shouldn't underestimate the importance of print media for local grassroots organizations and activism. That flyer you posted on a local community cork board or left at your neighborhood coffee house might reach people your social media updates won't!

    While flyers, brochures and leaflets can be produced with Inkscape, dynebolic also provides Scribus, a full-fledged Desktop Publishing (DTP) environment.

    "},{"location":"getting_started/#writing-implements","title":"Writing Implements","text":"

    Whatever you intend to publish, chances are that you'll need to write some copy. No matter what you intend to do with it, there's no avoiding some banging on a keyboard for a while.

    For text- and document writing and editing, dynebolic includes LibreOffice, so you have the full feature set of an office suite.

    If you prefer leaner writing tools, dynebolic also includes the Kate advanced text editor. And, if you're feeling particularly 1337, at the command line you will find a recent version of the venerable Vim editor.

    "},{"location":"getting_started/#scribus","title":"Scribus","text":"

    Scribus is a desktop publishing program to compose vectorial formats like PDF and Postscript, it is useful to paginate text in a professional printable form to produce magazines, flyers and most publications that need to mix text and images in pages following customizable schemes.

    "}]} \ No newline at end of file +{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Dynebolic IV GNU/Linux User's Guide","text":"

    2024 Denis Jaromil Rojo & The dynebolic Documentation Team

    "},{"location":"#what-is-dynebolic","title":"What Is dynebolic?","text":"

    Dynebolic is a 100% Free Software Operating System for multimedia production, recommended by the Free Software Foundation. It is a live ISO that can run from a CD or Drive, without the need to install.

    "},{"location":"#be-welcome-to-a-gnulinux-world","title":"Be Welcome to a GNU+Linux World!","text":"

    For culture and information to circulate freely and unbiased, media activists, artists and creatives need to be independent from corporate alienation. Dynebolic is an Operating System and a practical tool for multimedia production: it enables the manipulation and broadcasting of both audio and video with tools to record, edit, encode, stream, and publish. Dyne:bolic automatically recognizes most device and peripherals: audio, video, TV, network cards, firewire, usb and more; all using only free software!

    "},{"location":"#100-free-as-in-speech","title":"100% Free, As In Speech","text":"

    Dynebolic is a GNU+Linux distribution recommended by the Free Software Foundation: no proprietary software is inside, no closed source firmware, no hockus pockus. Everything is transparent and can be peer reviewed. All of this without ever compromising with the expression creatives rely on.

    You are free to study, modify, redistribute and even sell this Operating System, as long you grant the same freedom to your peers.

    "},{"location":"#friendly-to-the-environment","title":"Friendly To The Environment","text":"

    Dynebolic is designed to run on computers with extremly low ressources (dynebolic III was benchmarked at Pentium2 processors with 256MB RAM). It can even run in ram: not even a harddisk is required.

    Unleash the full potential of computers, including second hand machines. Let\u2019s put an end to consumerism and use what already exists to its full potential.

    "},{"location":"#digital-resistance","title":"Digital Resistance","text":"

    The dynebolic Operating System is about resilience and digital resistance. In a reality where governments and corporation are exercising control by monitoring the way people communicate, hackers, creatives and citizens of the digital era have a common interest in keeping their computing sovereign. To accomplish this, sharing knowledge is paramount.

    Liberate yourself from mental slavery. Embrace sovereign communication. Free your mind, open the source!

    "},{"location":"#freedom-needs-privacy","title":"Freedom Needs Privacy","text":"

    Dynebolic Operating System does not include any cloud-service and does not establish background communications without the consent of the user.

    Dynebolic also includes support for strong encryption of private data, thanks to Dyne.org's Tomb.

    "},{"location":"#freedom-of-expression","title":"Freedom of Expression","text":"

    More than the means of media playback, dynebolic includes free software for the production of professional grade multimedia.

    For everything you can see and play, dynebolic includes the software to create it. This Operating System lets you express yourself, without the need to rent a license or install additional components. dynebolic was built to make it possible for people to be the independent producers of their own story. Not just content creators for corporate platforms or consumers of information.

    "},{"location":"#appreciated-worldwide","title":"Appreciated Worldwide","text":"

    Since its birth in 2000, dynebolic has been redistributed by several magazines and adopted by universities, community initiatives, medialabs and public institutions around the World.

    "},{"location":"#how-is-dynebolic-different-from-other-live-distros","title":"How is dynebolic different from other live distros?","text":"

    True to the original desire to put digital power in the hands of the people, we craft dynebolic to fill the gap between expression and technology. Our legacy stretches over decades.

    Free Software is the idea that, operating-, using-, modifying- and sharing- means of digital production, is the only way for humans to create and communicate safely in the digital realm. With dynebolic we apply this idea, to a carefully curated list of applications and utilities, in ways that align perfectly with the principles of Free Software. More than a distribution, dynebolic is a human centric community, facilitating professional grade multimedia tools to the masses.

    dynebolic is a nomadic system, meaning it is ready to move in to your device with a minimum of material friction. But it shall also follow you on the road, where the conditions may be unpredicatble. For many dynes, it is a gateway to the freedom to compute and a reaching hand for travelers looking to onboard the liberty of expression.

    "},{"location":"appendix/","title":"Appendix II: The Dyne Foundation","text":"

    Dynebolic is brought to you by the Dyne Foundation. The Dyne Foundation is a think & do tank, born as an on-line community in 1999 by uniting artists, activists and hackers of mixed backgrounds. It is also a young research organization working on a growing number of succesful projects for the European Commission. These are its three guiding principles:

    The Dyne Foundation develops and promotes projects focused on free software and free culture, and hosts the development of a large selection of free software. Notably, the Dyne Foundation hosts and supports the development of the Devuan \"init freedom\" Linux Distribution, which dynebolic is based on.

    "},{"location":"appendix/#appendix-iii-links-and-other-sources-of-information","title":"Appendix III: Links and other sources of information","text":""},{"location":"appendix/#further-info","title":"Further info","text":""},{"location":"appendix/#other-documentation-sources","title":"Other Documentation sources","text":""},{"location":"appendix/#online-communities","title":"Online Communities","text":""},{"location":"appendix/#license","title":"License","text":"

    GFDL, I believe.

    "},{"location":"bootingonusb/","title":"Booting dynebolic","text":"

    There are many ways to boot dynebolic on your computer. First, you need to download the ISO file and verify the checksum.

    "},{"location":"bootingonusb/#booting-from-usb","title":"Booting from usb","text":""},{"location":"bootingonusb/#on-windows","title":"On windows","text":"

    On Windows you can use an application called Rufus to flash the ISO file to a USB drive. The interface is very intuitive, plug the usb stick, select the volume to install on and the ISO image you just downloaded to install. After pressing start it will recognize the image and will ask you to either install normally or in dd mode, please select dd mode.

    "},{"location":"bootingonusb/#on-gnulinux","title":"On GNU+Linux","text":"

    On GNU+Linux, find the device name of your USB stick, with this command: lsblk -o NAME,SIZE,RO,TYPE,VENDOR,HOTPLUG

    The name you are looking for should be something like /dev/sdX (where \"X\" is a letter defined by your system). Read the information carefully, because it will include de sdX name of the main drive of your computer. Once you've determined the name of your USB stick, run this command as root:

    dd bs=4M if=dynebolicIV.iso of=/dev/sdX status=progress && sync

    Note

    You have to adapt this line so that \"X\" represents its actual value in your system.

    Once this command has completed, the USB stick will be ready to boot.

    Be sure to know the hotkey to press at boot for boot selection, or bios interface to configure USB boot.

    "},{"location":"bootingonusb/#booting-in-a-virtual-machine","title":"Booting in a Virtual Machine","text":"

    A virutal machine allows you to run an Operative System within your running Operative system. This way you can leverage all that dynebolic has to offer without the need to install it on your machine.

    "},{"location":"bootingonusb/#virtual-machine-manager","title":"Virtual Machine Manager","text":"

    On of the most user-friendly ways to run dynebolic in a virutal machine is using Virtual Machine Manager. This tool will provide you with a GUI and take care of many complicated parts such as the routing to your physical audio and network tools more or less seemlessly. It also sets everything up to have copy+paste working from your physical machine's desktop to dynebolic.

    To install Virtual Machine Manager, follow the instructions on their website

    Once installed you can run it an add a virtual machine. To do this follow these intstructions

    Hit the \"+\" button in the upper left corner of the GUI. You will be presented with a prompt asking you to choose how you would like to install the operative system.

    Chose \"Local install media\"

    In the next panel, you are asked to pick the file you want to use.

    Chose ISO

    This will open prompt that allows you brose your file system. Click \"Browse Local\" and locate the ISO file you downloaded from dynebolic.org

    Pick the ISO file you downloaded

    You will come back to the previous window, chose an operative system. Since Devuan is based on Debian chose, \"Debian 12 and click \"Forward\".

    In the next prompt, you are invited to allocate resources to the virtual machines in terms of CPU cores and RAM. You can safely allocate half of your resouces for both. In this example the machine has 4 cores and 4GB (4096 bytes) ram. So we allocate 2 cores and 2Gb (2048 bytes) RAM.

    Alocate resources

    In the next prompt, you can allocate disk space to your virtual machine. This is a file that will be mounted as if it was a drive. It will contain all the data you create, so you might want to choose a good location for it. The extention for the file is .qcow2. In the screenshot bellow, we gave it 10Gb and stored the file in ~/Documents/dynebolic.qcow2

    Alocate diskspace

    We then get a chance to review the settings and name the Virtual Machine. Let's name it \"dynebolic\" and click \"Finish\".

    Name the Virtual Machine

    This will initiate the virtual machine and you should now see a virtual screen with a boot slection. Pick the first entry by hiting the Enter key on your keyboard.

    Run the Virtual Machine

    Voil\u00e0! Give a few moments, and dynebolic will boot inside your computer.

    "},{"location":"bootingonusb/#qemu-todo","title":"QEMU (TODO)","text":"

    QEMU is a generic and open source machine emulator and virtualizer.

    "},{"location":"bootingonusb/#on-windows-todo","title":"On windows (todo)","text":""},{"location":"developers/","title":"For Developers","text":"

    Greetings, fellow devel! \ud83d\udd96\ud83c\udffd

    dynebolic welcomes contributions, big and small. You are here by invited to clone the repository localy and get yourself an account on the Devuan Gitea. For your convenience the repository is mirrored on GitHub. However, due to the ownership model of GitHub we encourage you to stick to the Devuan Gitea. From the Gitea interface you will be able to fork the repository and send Pull Requests. But you are welcome to ask for write permission in the bridged chat.

    "},{"location":"developers/#source-code","title":"Source code","text":"

    https://git.devuan.org/jaromil/dynebolic

    "},{"location":"developers/#come-talk-to-us","title":"Come talk to us","text":"

    These channels are all bridge, meaning it doesn't matter whether you are using one or the other, you will be able to communicate with everyone.

    "},{"location":"developers/#the-dynebolic-sdk","title":"The dynebolic SDK","text":""},{"location":"developers/#dynebolic-modules","title":"Dynebolic Modules","text":""},{"location":"developers/#system-development","title":"System Development","text":""},{"location":"developers/#developing-for-the-desktop","title":"Developing For The Desktop","text":"

    The dynebolic SDK offers various workflows. To get the full list of targets, cd into your cloned repository and run make. This will present you with a list of Make targets that will help you contribute to the project.

    "},{"location":"developers/#getting-dynebolic-development-up-and-running","title":"Getting dynebolic development up and running","text":"

    The two workflows Desktop devleopers are interested in are \"Quick start\":

     ----             __ Quick start:\n deps             \ud83d\udee0 Install development dependencies\n setup            \ud83d\udce5 Download the latest development ROOT modules\n system           \ud83d\uddff Build the root system: dyneIV-root\n iso              \ud83c\udfc1 Create the current ISO image\n qemu             \ud83d\udda5 Emulate UEFI USB boot using qemu\n burn             \ud83d\udd25 Write the ISO to a removable USB=/dev/sd?\n

    and \"Snapshot testing\"

     -----            __ Snapshot testing functions:\n snap-iso         \ud83e\udde8 Test a squashed snapshot as ISO FILE=path\n snap-mount       \ud83d\udc40 Explore the contents of a snapshot FILE=path\n snap-umount      \ud83d\udd0c Stop exploring and unplug the snapshot\n test-changes     \ud83c\udf73 Test current changes in home and static\n
    Most of these make commands need to be run as root. This can be achieved in different ways depending on your operating system.

    To bootstrap your Desktop development environement, follow this sequence:

    1. make deps (requires root)
    2. make setup (requires root)
    3. make system (requires root)
    4. make iso (requires root)

    Each command will take a moment to complete and be quite verbose. Don't fear it. It might look scary, but your computer is talking to you, so listen!

    Once you have ran all of the four commands, there will be a new file in your local repository called dynebolic.iso. This is an image of the dynebolic install disk.

    You can now test it by running:

    1. make qemu

    This will start a virtual environement in which dynebolic will boot. If everything was made correctly, you will see the grub menu. Pick the first entry.

    grub menu

    Soon see the desktop appear. Once it does, you can proceed and make changes to the desktop and then export them. Even though it is slightly more time consuming, it is advisable to make one change and export at the time.

    "},{"location":"developers/#export-changes","title":"Export changes","text":"

    Once you have made the desired changes, from within the virutal d:b dekstop, start a terminal and become root. To do this type: su. The system will ask you for a password. The password is dyne. It will look like this:

    dyne@dynebolic ~ \u276f su\nPassword:\nroot@dynebolic:/home/dyne#\n

    The user changed to root, and you may now export your changes. To do this, type:

    dyne-snapshot

    Accept the identity of the remote server, by typing yes and hitting enter.

    This will fetch any modified file, package them into a single file and upload them to the snapshot server. You will be presented with a URL. Using this method, you won't be able to copy it from your virtual machine to your machine. To fetch this snapshot, either use the QR code with your phone to transfer it to yourself. Or head over to the snapshot server and sort the files by \"Last Modified\".

    "},{"location":"developers/#inspecting-changes-to-commit-them","title":"Inspecting changes to commit them.","text":"

    Terminate the virutal machine for now. To inspect your snapshot, download your snapshot to the root of your cloned repository and mount it.

    This will create a folder in the root of your cloned repository called \"snap-mount\" containing all the modified files. Navigate into it and run ncdu.

    cd snap-mount\nncdu\n

    This will show you a browser like view where you can browse through the modified files. To close it, hit the \"Q\" key on your keyboard

    Still as root, copy the files you are interested in to a different folder:

    In the root of your cloned repository, there is a folder called static. This is where the configuration files for the desktop and system are residing. Copy over the files to this folder following the same structure. If your file is snap-export/home/dyne/.config/my-amazing-settings.conf, move it to static/home/dyne/.config/my-amazing-settings.conf

    Once you have done this, you need to make sure that your changes are going to give the desired effect. This because, maybe you forgot something? Maybe there are more files responsible for the changes you want?

    This will launch a virtual machine taking into account your changes. When the desktop appears, you should be able to see your changes. If you do, commit them to the repository:

    "},{"location":"developers/#appendices","title":"Appendices","text":""},{"location":"developers/#appendix-i-a-brief-history-of-dynebolic","title":"Appendix I: A Brief History of dynebolic","text":"

    The first edition of dynebolic was released

    "},{"location":"disclaimer/","title":"Disclaimer","text":""},{"location":"disclaimer/#disclaimer","title":"Disclaimer","text":"

    Dynebolic GNU/Linux is copyright (C) 2001 - 2024 Denis Jaromil Roio

    Dynebolic is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

    "},{"location":"getting_started/","title":"Getting Started with dynebolic","text":""},{"location":"getting_started/#your-desktop-environment","title":"Your Desktop Environment","text":"

    Dynebolic doesn\u2019t require you to install anything on your harddisks, which can be left untouched while the system is used. Still, depending from your preferred way to operate, it can boot from harddisk, CD, USB or network (explained the following chapter) and it can store data in a single file that can be transported across different media.

    The default desktop environment is KDE Plasma 6, which offers you multiple desktops (try ctrl+F2 and other numbers) and a menu that you can recall by clicking the right mouse button on the background. On the upper right corner you have your storage devices which you can access with a click.

    Inside the application menu software is organized by tasks, so you can easily find your way to play, record, edit and stream both audio and video, communicate and publish text, webpages, 3d animations and much more.

    KDE Plasma offers Activities, which are a practical way to organize your workflows depending on the task at hand, whether you're editing video, recording and mixing audio, processing digital photographs, or running a live media stream. When you start your dynebolic desktop session, you will find a number of pre-configured Activities: Audio, Video, Streaming, etc. You can think of these Activities as workplaces dedicated to a particular line of work. They are, of course, not exclusive: nothing stops you from pulling out Inkscape to work on an album cover for a track you're currently mastering in the Audio Activity.

    In the following chapters, we will look at what is available to you in each Activity.

    "},{"location":"getting_started/#working-with-video","title":"Working with Video","text":""},{"location":"getting_started/#introduction","title":"Introduction","text":"

    The GNU/Linux platform nowadays offers an interesting range of tools for video production, editing and manipulation; you can play all kind of video files, but also encode them for distribution and switch between formats. Furthermore, you\u2019ll find software for recording, veejaying and streaming, non-linear editing and subtitling.

    However, you should consider that most of the video tools running on GNU/Linux platform are in development: indeed you can help much in testing and reporting the bugs you encounter, that\u2019s how anyone can help free software to grow better and better, as it does.

    Now let's proceed on how to configure an available video device and then browse thru the video software included in dynebolic, following a subdivision in task categories.

    "},{"location":"getting_started/#configure-your-video-devices","title":"Configure your video devices","text":"

    There are various devices that can be used on PC computers in order to have video input: USB webcams and capture cards, PCI TV cards, Firewire and even parallel port. They all have different chipsets and manufacturers and need different Linux device drivers.

    Dynebolic is capable of automatically recognizing most PCI (internal) TV cards at boot time (WinTV, BTTV) and now also USB webcams as well as Firewire controllers: they will all be initialized at boot and can be accessed from the video device /dev/video0 or subsequent numbers (video1, video2 \u2026.) in case you have more than one. [FIXME: double-check that]

    If your video device is not recognized automatically (the /dev/video doesn\u2019t exist) then you need to configure it by hand.

    If the online documentation says your device is supported by a particular kernel driver, you can try to load it using the command modprobe modulename and see if everything went well by looking in the last lines of the messages printed out by the dmesg command. Many modules are already present in dynebolic, but some might require to be compiled using the kernel sources, which is a more complicated process that can\u2019t be explained here: you\u2019ll need to find more instructions online about how to do it and download the Linux kernel sources. If you\u2019ll even do it, keep in mind that once you have compiled your own kernel you have moved your very first step into becoming a hacker ;).

    "},{"location":"getting_started/#video-tools-and-programs","title":"Video tools and programs","text":""},{"location":"getting_started/#kdenlive","title":"KDEnlive","text":"

    KDEnlive (the KDE Non-Linear Video Editor) is one of the best free and open-source video editing programs. It is based on the MLT Framework, which allows it to integrate many plugin effects for video and sound processing or creation. Furthermore KDEnlive brings a powerful titling tool, a DVD authoring solution, and can be used as a complete studio for video creation.

    "},{"location":"getting_started/#frei0r","title":"Frei0r","text":"

    Frei0r is a free and open source plugin collection for video effects. Applications can use its API to embed more than 100 video filters, sources and mixers.

    Frei0r is a minimalistic plugin API for video effects. The main emphasis is on simplicity for an API that will round up the most common video effects into simple filters, sources and mixers that can be controlled by parameters. It\u2019s our hope that this way these simple effects can be shared between many applications, avoiding their reimplementation by different projects.

    Frei0r is not meant as a competing standard to more ambitious efforts that try to satisfy the needs of many different applications and more complex effects. It is not meant as a generic API for all kinds of video applications, as it doesn\u2019t provides things like an extensive parameter mechanism or event handling. Eventually the frei0r API can be wrapped by higher level APIs expanding its functionalities (for instance as GStreamer, MLT, FFmpeg and others do).

    Frei0r has been developed with production video software in mind, not video players or desktop toys of sorts. For instance it can be used like GStreamer, but its different as it aims to be lighter, for instance allowing host application developers to avoid memcpy and other buffering operations. Also it doesn\u2019t enforces dependency from GNOME and such desktop frameworks.

    "},{"location":"getting_started/#etc","title":"Etc.","text":""},{"location":"getting_started/#working-with-audio","title":"Working with Audio","text":"

    This distribution is full with audio software to do all kind of things: electronic music, sound processing, voice effects, interviews and more. And there is one important thing that makes this system superior to any other commercial solution: there is no competition :)

    Most of the audio applications in dynebolic can be connected together, input to output, in order to form a chain of tools processing the sound: this is done thanks to a technologies like Pipewire, JACK and the Advanced Linux Sound Architecture (ALSA). Instead of keeping separated the tasks of every single application, now it is possible to take advantage of the great variety of approaches that a GNU/Linux system like dynebolic has to offer.

    "},{"location":"getting_started/#audio-tools-and-programs","title":"Audio tools and programs","text":""},{"location":"getting_started/#audacity","title":"Audacity","text":"

    Audacity is a user-friendly audio editing program suitable to manipulate your audio files, interviews and recordings, separating or mixing them, applying effects and encoding in various formats. It can also be used to record audio straight away via its intuitive interface, which can be commonly found also on other operating systems since it is a cross-platform free application. A perfect choice to start manipulating audio.

    "},{"location":"getting_started/#ardour","title":"Ardour","text":"

    Ardour is the fully featured multitrack studio that offers the most advanced interface for your music recording studio. Combined together with other applications when necessary (it also uses Jack) it can really solve all your needs for audio mastering and music production. Check the online documentation for this valuable software on the Ardour homepage: if you are a musician, the patience needed to learn it\u2019s usage and hotkeys is definitely worth the effort.

    "},{"location":"getting_started/#mixxx","title":"Mixxx","text":"

    Mixxx is currenly the most popular libre DJ Automation and digital DJ performance application. It includes many features common to digital DJ solutions as well as some unique ones: it natively supports advanced MIDI and HID DJ controllers, is licensed under the GPL-2.0-or-later and runs on all major desktop operating systems. The project was started in early 2001 for a doctoral thesis as one of the first digital DJing systems

    "},{"location":"getting_started/#some-technicalities","title":"Some technicalities","text":""},{"location":"getting_started/#audio-servers","title":"Audio servers","text":"

    The zoo of Linux audio servers.

    (Obligatory XKCD 927 here.)

    1. The ALSA audio back-end.

    2. The JACK audio server

      Still going strong.

    3. Pulseaudio

      Explain why Pulseaudio is a Crime against Nature, and why \"Poettering\" is a gerund.

      (I honestly hope we won't have to deal with PA here.)

    4. The Pipewire audio server

      One media server to rule them all.

    "},{"location":"getting_started/#pipewire-session-management","title":"Pipewire Session Management","text":""},{"location":"getting_started/#streaming-media","title":"Streaming Media","text":"

    Now that you have worked hard on your media, be it a podcast, experimental video, music, or sound art, you might feel the need to get it out there in the world. As far as streaming media goes, dynebolic's Streaming Activity has you covered.

    "},{"location":"getting_started/#obs-studio","title":"OBS Studio","text":"

    OBS Studio (the Open Broadcaster's Software Studio) is a free and open-source, cross-platform app for screencasting screencasting and live streaming. It is available for Linux and BSD distributions, as well as other operating systems. OBS Studio provides real-time capture, scene composition, recording, encoding, and broadcasting via Real-Time Messaging Protocol (RTMP), HLS, SRT, RIST or WebRTC. It can stream videos to any RTMP-supporting destination, including YouTube, Twitch, Instagram and Facebook

    In recent years (and especially in the wake of the COVID-19 crisis), OBS Studio has become the most popular tool for countless podcasts, live streaming sessions, news broadcasts, or live coding. It can use any number of cameras and sound sources, and can be comfortably configured to stream any computer screen or program window we choose.

    "},{"location":"getting_started/#butt","title":"BUTT","text":"

    If our streaming project doesn't need all the power and features of OBS Studio, or we need to join a broadcast using an Icecast server, the ideal tool for the job is BUTT.

    Broadcast Using This Tool (charmingly contracted to BUTT) is an easy to use, multi-OS streaming tool. It supports SHOUTcast and Icecast and runs on Linux and other operating systems. The main purpose of BUTT is to stream live audio data from your computers mic or line input to a Shoutcast or Icecast server. It also has facilities for recording our session.

    One peculiarity of BUTT is that it is focused on live audio - that is, it will broadcast a microphone, instrument, or software synth source to the Icecast server's mount point, but it will not stream recorded media files. (But nothing stops you from using it to stream your DJ session with Mixxx, for example.)

    "},{"location":"getting_started/#working-with-graphic-design","title":"Working With Graphic Design","text":""},{"location":"getting_started/#inkscape","title":"Inkscape","text":"

    Inkscape is a free and open source vector graphics editor for GNU/Linux and other operating systems. It offers a rich set of features and is widely used for both artistic and technical illustrations such as cartoons, clip art, logos, typography, diagramming and flowcharting. It uses vector graphics to allow for sharp printouts and renderings at unlimited resolution and is not bound to a fixed number of pixels like raster graphics. Inkscape uses the standardized SVG file format as its main format, which is supported by many other applications including web browsers. It is an ideal tool for flyers, high-resolution prints and pre-flight DTP work.

    "},{"location":"getting_started/#krita","title":"Krita","text":"

    Krita is a free and open source cross-platform application that offers an end-to-end solution for creating digital art files from scratch. It is made by artists that want to see affordable art tools for everyone. Krita is optimized for frequent, prolonged and focused use. Explicitly supported fields of painting are illustrations, concept art, matte painting, textures, comics and animations. Krita supports open standards and interoperates with other applications.

    Krita\u2019s tools are developed keeping the above vision in mind. Although it has features that overlap with other raster editors its intended purpose is to provide robust tool for digital painting and creating artworks from scratch.

    "},{"location":"getting_started/#blender","title":"Blender","text":"

    Blender is the free and open source 3D creation suite. It supports the entirety of the 3D pipeline\u2014modeling, rigging, animation, simulation, rendering, compositing and motion tracking, even video editing and game creation. Advanced users employ Blender\u2019s API for Python scripting to customize the application and write specialized tools; often these are included in Blender\u2019s future releases. Blender is well suited to individuals and small studios who benefit from its unified pipeline and responsive development process. Examples from many Blender-based projects are available in the showcase.

    Blender is cross-platform and runs equally well on Linux and other operating systems. Its interface uses OpenGL to provide a consistent experience. To confirm specific compatibility, the list of supported platforms indicates those regularly tested by the development team.

    Indeed, Blender is such a powerful and complex multimedia tool, that it fits equally well in the Video and here in the Graphic Design Activities of dynebolic.

    "},{"location":"getting_started/#working-with-photography","title":"Working With Photography","text":"

    Whether you just need to crop or apply an effect on a bitmap image, or you need to establish a good RAW development workflow, the Photography Activity has the tools for you.

    "},{"location":"getting_started/#gwenview","title":"Gwenview","text":"

    Gwenview, the KDE Plasma default image viewer, is a fast and lean tool for viewing images and browsing and annotating picture collections. It even offers some basic editing operations, such as image resizing and cropping, which make it very handy for moments when a heavier tool would be overkill.

    "},{"location":"getting_started/#the-gnu-image-manipulation-program","title":"The GNU Image Manipulation Program","text":"

    The GNU Image Manipulation Program is a well mature application capable to create and edit bitmap images, offers a perfect environment for web graphics as well a powerful script engine to automatize its operations and even generate automatically stylish logos.

    "},{"location":"getting_started/#darktable","title":"Darktable","text":"

    Darktable is an open source photography workflow application and RAW developer. A virtual lighttable and darkroom for photographers. It manages your digital negatives in a database, lets you view them through a zoomable lighttable and enables you to develop RAW images and enhance them.

    "},{"location":"getting_started/#digikam","title":"digiKam","text":"

    digiKam is an advanced open-source digital photo management application that runs on Linux and other operating systems. The application provides a comprehensive set of tools for importing, managing, editing, and sharing photos and raw files. While digiKam also has RAW development capabilities, its strong point is in library management and cataloging. It also has a useful set of plugins which enable direct publishing to online sites such as Flickr and others.

    "},{"location":"getting_started/#the-lensfun-database","title":"The lensfun database","text":"

    Dynebolic comes with enough powerful tools for digital photography to satisfy a photographer's needs. Nevertheless, an important step in setting up our digital photography workflow is updating the lensfun database. lensfun is an open, collaborative database of camera and lens profile, which are essential for RAW development operations, such as lens correction. If Darktable can't find the profile of your camera model or lens (or at least the closest possible one), chances are your lensfun database hasn't been updated.

    To do this, we open Konsole, and do the following:

    > lensfun-update-data\n

    And that's it. You won't need to do anything else - Darktable or other RAW processing tools will use the updated lensfun database in the background.

    "},{"location":"getting_started/#learn-more","title":"Learn more","text":""},{"location":"getting_started/#publishing","title":"Publishing","text":"

    Although nowadays most of what we call \"publishing\" happens online, we shouldn't underestimate the importance of print media for local grassroots organizations and activism. That flyer you posted on a local community cork board or left at your neighborhood coffee house might reach people your social media updates won't!

    While flyers, brochures and leaflets can be produced with Inkscape, dynebolic also provides Scribus, a full-fledged Desktop Publishing (DTP) environment.

    "},{"location":"getting_started/#writing-implements","title":"Writing Implements","text":"

    Whatever you intend to publish, chances are that you'll need to write some copy. No matter what you intend to do with it, there's no avoiding some banging on a keyboard for a while.

    For text- and document writing and editing, dynebolic includes LibreOffice, so you have the full feature set of an office suite.

    If you prefer leaner writing tools, dynebolic also includes the Kate advanced text editor. And, if you're feeling particularly 1337, at the command line you will find a recent version of the venerable Vim editor.

    "},{"location":"getting_started/#scribus","title":"Scribus","text":"

    Scribus is a desktop publishing program to compose vectorial formats like PDF and Postscript, it is useful to paginate text in a professional printable form to produce magazines, flyers and most publications that need to mix text and images in pages following customizable schemes.

    "}]} \ No newline at end of file diff --git a/dynebolic/sitemap.xml b/dynebolic/sitemap.xml index 0eb8fdb..b33bf42 100644 --- a/dynebolic/sitemap.xml +++ b/dynebolic/sitemap.xml @@ -2,32 +2,32 @@ https://dyne.org/docs/dynebolic/ - 2024-06-07 + 2024-06-10 daily https://dyne.org/docs/dynebolic/appendix/ - 2024-06-07 + 2024-06-10 daily https://dyne.org/docs/dynebolic/bootingonusb/ - 2024-06-07 + 2024-06-10 daily https://dyne.org/docs/dynebolic/developers/ - 2024-06-07 + 2024-06-10 daily https://dyne.org/docs/dynebolic/disclaimer/ - 2024-06-07 + 2024-06-10 daily https://dyne.org/docs/dynebolic/getting_started/ - 2024-06-07 + 2024-06-10 daily \ No newline at end of file