Lidiando con el portapapeles en Nvim+Linux+Wayland

2026-10-04T00:00:00+00:00

Cuando hablamos de portapapeles en Linux hablamos de PRIMARY</code> y de CLIPBOARD</code>. Las operaciones copy/paste</a> son utilizadas masivamente por los usuarios de los sistemas informáticos y son esenciales especialmente para desarrolladores. Su comportamiento en entornos gráficos sigue una serie de principios establecidos y discutidos por freedesktop.org</a> que habla también de SECUNDARY. Cada una de estas variables pueden contener datos distintos los cuales no tienen porqué ser texto plano sino cualquier otro tipo de dato asociado a su MIME/Type</a>.</p>

Establecidos los principios, los servidores gráficos Xorg</a> y Wayland</a> deben implementar su propia gestión del portapapeles.</p>

Aunque desde freedesktop indican que primary funciona de manera prácticamente transparente, copiando automáticamente las selecciones</a> y pegando con el botón dentral del ratón, la realidad es que esto no parece funcionar de tal manera, al menos para mi ya que mi entorno tiene otros usos para ese botón central.</p>

Sea como fuere mientras en Windows se trabaja con un "único portapapeles" en Linux esto no sucede y lo que me ha llevado a enfrentar algún problema por incoherencias con el pegado desde el mismo cuando uso Nvim</a>.</p>



Nvim puede copiar y pegar hacia y desde dos "portapapeles" distintos.</figcaption>
</figure>
Lo que me ha llevado a escribir esto</h3>
Si dentro de Nvim seleccionas texto y pulsas botón derecho del ratón obtienes opciones para el manejo del copiado y pegado de texto. Esto funciona correctamente, si te diriges a otra aplicación como por ejemplo el navegador Firefox, y copias texto con Ctrl-C</code> y luego lo pegas con Ctrl-V o Shift-Ins</code> en la ventana de ese navegador funciona correctamente, cuando lo pegas en con el menu contextual de Nvim se pega correctamente y si lo haces con Shift-Ins también.</p>

	En Nvim Ctrl-V tiene otras funciones, la combinación para el pegado es Ctrl-Shift-V</code> pero Shift-Ins realiza el mismo comportamiento y al menos a mi me resulta más cómoda.</p>

</blockquote>
Si vuelvo a seleccionar algo en Nvim y usamos el botón derecho para copiar y posteriormente pegar, el contenido del portapapeles parece actualizado, pero si vuelves a usar Shift-Ins se pega en mi caso el contenido copiado del navegador.</p>
Lo que a mi me sucede:</p>

Copia un texto del navegador Firefox ya sea con Ctrl-C o con la opción de copiar del menu contextual, lo llamo [Firefox].</li>
Copio un texto del buffer de Nvim utilizando el menu contextual, lo llamo [Nvim].</li>
Si pego con el botón derecho en Nvim obtengo [Nvim], si lo hago con Shift-Ins obtengo [Firefox].</li>
Si vuelvo a Firefox y pego con el menu contextual obtengo [Nvim] y si pego con Ctrl-V o Shift-Ins pego igualmente [Nvim].</li>
</ol>
En Nvim existe un lugar propio donde alojar datos para copiar y pegar, algo que funciona como un portapapeles interno. Esto se hace con las operaciones yank, delete y paste</a>. Para hacer que Nvim utilice el portapapeles del sistema en lugar del interno se puede configurar con vim.opt.clipboard = "unnamedplus"</code>. Más información con :h clipboard</code></a> en Nvim.</p>
Al final el comportamiento esperado según lo dicho por freedesktop queda en manos de quien implementa el comportamiento de los menús contextuales y las respuestas a la pulsación de las teclas.</p>

	Para profundizar en el tema en el siguiente enlace podemos ver como Wayland opera con la Primary selection</a> y la documentación del ext data control</a> que es el encargado de operar con el portapapeles</p>

</blockquote>
Mi gestor de portapapeles: wl-clipboard</h3>
Como gestor de portapapeles en Wayland uso wl-clipboard</a> el cual instalo en mi Arch con sudo pacman -S wl-clipboard</code>.</p>
Este paquete lo que hace es "engancharse" a las operaciones de copiado y pegado de Wayland enviando el contenido a wl-copy</code> y tratándolo de obtener con wl-paste</code>.</p>
Podemos ver el contenido del portapeles con los comandos wl-paste</code> para ver el contenido de CLIPBOARD o wl-paste --primary</code> para ver el contenido de PRIMARY.</p>
Reproduciendo los pasos que indiqué en el apartado enterior y usando después los comandos dados se sacan las siguientes conclusiones.</p>

Lo copiado en Firefox (y probablemente en cualquier otra aplicación GTK</a>) acaba tanto en PRIMARY como en CLIPBOARD.</li>
Lo copiado en Nvim con el menu contextual se copia únicamente a CLIPBOARD.</li>
Lo pegado en Nvim con el menu contextual es lo que existe en CLIPBOARD, mientras que lo pegado con Shift-Ins es el contenido de PRIMARY.</li>
Lo pegado en Firefox es el contenido de CLIPBOARD.</li>
</ol>
Hablando de otras aplicaciones por ejemplo mi aplicación para termina es WezTerm</a> permite copiar seleccionando y utilizando Ctrl-C o simplemente haciendo click con el botón derecho y el comportamiento por defecto para esta operación copia la selección tanto en PRIMARY como en CLIPBOARD aunque puede establecerse otro comportamiento mediante configuración</a> eligiendo únicamente uno de los dos.</p>
Para no fallar usar Ctrl-R</h3>
Para evitar comportamientos extraños una opción sería forzar una sincronización permanente para lo que necesitaríamos ejecutar automáticamente algunas llamadas a wl-copy en segundo plano, al menos si usas wl-clipboard.</p>
En mi caso pienso que lo mejor es lidiar con ello. Una vez que conoces la existencia de dos portapapeles distintos, o como prefieras llamarlos, todo resulta un poco más sencillo de manejar.</p>
En el caso de Nvim hay que saber que Shift-Ins pega desde PRIMARY y si la aplicación desde la que copiaste utiliza únicamente CLIPBOARD tendrás que usar el menu contextual para pegar y en cualquier caso siempre está la opción de usar Ctrl-R</code> en modo inserción (copiar desde registro, :h i_CTRL-R</code></a>) y decidir qué insertar, ofreciéndose una diversidad de opciones entre las que estan la copia desde el proveedor de portapapeles del sistema. Con la tecla +</code> inserta texto desde CLIPBOARD y con la *</code> desde PRIMARY. Respecto a ese portapapeles interno del que hablábamos las tecla "</code> inserta su contenido.</p>
Tanto + como * se consideran registros. Con Ctrl-R en modo inserción realizamos operaciones de lectura sobre los mismos y los insertamos en el lugar del cursor. Para realizar la escritura se debe pulsar "</code> en modo visual tras lo que obtendremos la lista de registros, seleccionado el registro correspondiente este quedará a la espera de datos, con la tecla y</code> podremos insertarles el texto seleccionado en ese modo visual. Vimos que Shift-Ins por defecto copiaba del PRIMARY y la realidad es que desconozco una combinación de teclas para copiar al PRIMARY (aunque podría crearla). Con "*y</code> haces esa operación.</p>
La modificación del contenido de ambos registros se realiza mediante el proveedor de clipboard o portapapeles el cual tiene inicialmente un comportamiento por defecto en función del proveedor de portapapeles del sistema detectado pero que puede sobreescribirse mediante la definición de la variable clipboard</code>. Para cambiar el comportamiento de manera global se puede hacer por ejemplo lo siguiente:</p>
vim.g.clipboard</span> =</span> {</span></span>
    name</span> =</span> "wl-clipboard"</span>,</span></span>
    copy</span> =</span> {</span></span>
        [</span>"+"</span>] </span>=</span> 'wl-copy --foreground --type text/plain'</span>,</span></span>
        [</span>"*"</span>] </span>=</span> 'wl-copy --foreground --primary --type text/plain'</span>,</span></span>
    },</span></span>
    paste</span> =</span> {</span></span>
        [</span>"+"</span>] </span>=</span> (</span>function</span>()</span></span>
            return</span> vim.fn.</span>systemlist</span>(</span>'wl-paste --no-newline|sed -e "s/</span>\r</span>$//"'</span>, {</span>''</span>}, </span>1</span>) </span>-- '1' keeps empty lines</span></span>
        end</span>),</span></span>
        [</span>"*"</span>] </span>=</span> (</span>function</span>()</span> </span></span>
            return</span> vim.fn.</span>systemlist</span>(</span>'wl-paste --primary --no-newline|sed -e "s/</span>\r</span>$//"'</span>, {</span>''</span>}, </span>1</span>)</span></span>
        end</span>),</span></span>
    },</span></span>
    cache_enabled</span> =</span> true</span></span>
}</span></span></code></pre>
Con ello cambiamos el comportamiento de la escritura y la escritura en los registros. Si hacemos :h g:clipboard</code></a> encontramos información sobre como configurar el proveedor de portapapeles.</p>
Solución particular para Nvim</h3>
Por otro lado si queremos cambiar el comportamiento de Ctrl-Shift-V, y de paso el de Ctrl-Ins, podemos modificar otra variable global llamada paste</code> (ver h: paste</code></a>). Modificando ese objeto (ver :h vim.paste())</code></a> podemos solucionar el problema para Nvim forzando que siempre se utilice el proveedor de CLIPBOARD. En mi caso al utilizar wl-clipboard obtengo el contenido con la llamada al comando del sistema wl-paste sin argumentos (con --primary obtendría el contenido de PRIMARY).</p>
vim.</span>paste</span> =</span> function</span>()</span></span>
    clipboard</span> =</span> vim.fn.</span>system</span>(</span>'wl-paste'</span>)</span></span>
    lines</span> =</span> {}</span></span>
    for</span> s</span> in</span> clipboard</span>:</span>gmatch</span>(</span>"[^</span>\r\n</span>]+"</span>) </span>do</span></span>
        table.insert</span>(lines, s)</span></span>
    end</span></span>
    vim.api.</span>nvim_put</span>(lines, </span>'c'</span>, </span>true</span>, </span>true</span>)</span></span>
end</span></span></code></pre>
Con esta modificación Shift-Ins insertará siempre lo que devuelva wl-paste y no únicamente cuando se trate de contenido catalogado como texto plano. Esto se puede evitar con la comprobación inicial del contenido buscando text/plain</code> en el resultado de wl-paste --list</code>.</p>

Arrecio's blog - Nvim

Lidiando con el portapapeles en Nvim+Linux+Wayland